版本

5.17.10.1. 修订记录

版本	修订日期	修订说明
V0.1	2024.6.13	初版
V0.5	2024.6.19	Modify-修订格式和个别图标引用问题
V1.0	2024.7.1	调整文档语句语义以及部分模块拍板问题。
V1.1	2024.9.3	VtunerClient新增和调整功能完善
V2.0	2026.8.30	依据 Vivante ISP Tuning Toolset User Guide v6.4.1（2026-04-22）相对 v6.4.0（2024-04-25）的变化，逐模块同步升级：去除PQ表述、Server泛化（新增RPC Server/ISPLite线）、补全协议与发行包说明、OS推荐版本更新等。

5.17.10.2. 1 X5 ISP introduction

本章概述了 X5 提供的 ISP Tuning工具

1.1 ISP Tuning工具简介

VTunerClient 是一个在您本地个人计算机 (PC) 上提供图形用户界面 (GUI) 的客户端，用于Tuning ISP 的特性。它负责从服务器收集数据并向其发送控制请求。

1.2 操作系统兼容性

Component	Operating System
VTunerClient	● Microsoft Windows 7 x64 or later ● Ubuntu 20 x64 with GUI or later

表格 1.21 OS Compatibility

1.3 Client-Server连接协议

VTunerClient 可以通过以下协议连接服务器：

Transmission Control Protocol (TCP)
Hypertext Transfer Protocol (HTTP)
Universal Asynchronous Receiver-Transmitter (UART)功能暂时不可用。

1.4 软件发行包

VTunerClient 安装文件为：

VTunerClient-<版本>-<产品>-Win32-x86_64-<时间戳>-Setup.exe（Windows 系统） VTunerClient-<版本>-<产品>-Linux-x86_64-<时间戳>-Install（Linux 系统）

说明：Tuning Server 的配置与搭建已在地瓜 SDK 中完成，用户无需自行配置，可直接启动 Server 使用。如需了解 RPC Server（ISPLite 软件），参见相关章节。

5.17.10.3. 2 VtunerClient

本章提供了有关如何使用 VTunerClient 进行 ISP Tuning的指南。

2.1 安装和启动

本节指导您如何安装和启动 VTunerClient。

一般来说，工作流程如下：

安装 VTunerClient。
启动 VTunerClient 工作台。创建一个 ISP 项目。
设置与Tuning Server的连接。

2.1.1 安装 VTunerClient

在本地个人计算机 (PC) 上安装 VTunerClient。

先决条件

目标操作系统满足第 1.2 节中列出的要求。
VTunerClient 可执行文件可用。
安装 VTunerClient 的 PC 屏幕分辨率为 1080P 或更高。

安装步骤

运行 VTunerClient 可执行文件以启动安装向导。
在“Install VTunerClient”对话框中，点击“yes”。
在 VTunerClient 安装向导的欢迎页面，点击“Next”。
在“License Agreement”页面，阅读许可协议。
要接受协议，请选择“I accept the terms of the license agreement”，然后点击“Next”。
在“Choose Destination Location”页面，点击“Browse”以选择安装 VTunerClient 的目标目录，然后点击“Next”。
在“Start Copying Files”页面，检查安装目录。

a) 如果选择的安装目录不正确，点击“Back”并转到第 6 步。

b) 如果安装目录正确，点击“Next”。
等待安装完成。
在安装完成页面，点击“Finish”。

安装结果

VTunerClient 已安装。
如果您使用的是 Windows 系统，则会在桌面上创建 VTunerClient 快捷方式。

后续步骤

如果要卸载 VTunerClient，可以运行 <installation_directory>/uninstall 启动卸载向导并按照向导完成卸载。

2.1.2 启动 VTunerClient 工作台

先决条件

确保已按照第 2.1.1 节的说明安装VTunerClient。

步骤

1，打开VtunerClient

a) 如果您使用的是 Linux 系统，在终端中运行 ./ide/vtunerclient.bat 文件。

b) 如果您使用的是 Windows 系统，请使用以下方法之一：

i. 选择“开始” > “X5” > “VTunerClient ”。

2，双击桌面上的 VTunerClient 快捷方式。在弹出的“Workspace Launcher”对话框中，选择一个工作区并点击“OK”。

a) 如果选择的工作区不存在，则会自动创建。如下图所示：

图 2.11 Workspace Launcher

启动结果

• VTunerClient 工作区已创建。

• 默认情况下，工作台显示在ISP Tuner。

2.1.3 创建ISP工程

本节介绍如何创建一个 ISP 项目。每个 ISP 项目包含一组用于 ISP tuner的特性设置。

先决条件

2.1.2 节确保 VTunerClient 工作台已启动。

步骤

在顶部菜单栏中，选择File > New > Project。

图 2.12 选择File > New > Project

在弹出的“New Project”窗口中，选择ISP> ISP Project Wizard，然后点击“Next”。这时会弹出 ISP 项目窗口。

图 2.13 创建ISP工程示例

在“Project name”文本框中，输入要创建的项目名称。项目名称只能包含字母、数字和下划线。不支持其他特殊字符。
如果要在默认位置创建项目，选择“Use default location option”选项。如果要自定义目标位置，请清除该选项，点击位置右侧的“Browse”，然后选择该位置。
从“Target names”下拉列表中选择一个Tuning模板。
点击“Finish”以创建项目。

操作结果

• ISP 项目已创建并列在项目资源浏览视图中。

• 在指定位置创建了一个与项目同名的文件夹。

2.1.4 设置连接服务

本节指定tuning Server的 IP 地址和口，并相应地将 VTunerClient 连接到tuning Server。

先决条件

• VTunerClient 工作台显示在视图。有关说明，请参见第 2.1.2 节。

操作过程

在地瓜SDK中启动tuning server（必须要在启动数据流之前启动tuning Server，否则无法连接成功）

a) 方式1：终端中输入echo 1 > /sys/kernel/debug/isp/tune
b) 方式2：使用集成好的Tuning tool脚本启动（1和0分别代表启动和关闭server）

图 2.14 开发板端启动Tuning Server

在工具栏中，点击。这时会弹出Server Configuration对话框。

图 2.15 建立Tuning Server与HTTP/TCP的连接

从“Connection Type”下拉列表中选择 VTunerClient 和Tuning Server之间要使用的协议。

有关支持的协议信息，请参见第 1.3 节

连接类型设置为 TCP，请执行以下步骤：

a) 在“Host(name or IP)”和“Port”文本框中输入Tuning Server的板端IP 地址和端口号，端口号为”45678”。
b) 点击“Add”将Tuning Server添加到主机列表。 i. 如果主机信息右侧出现感叹号（!），表示访问Tuning Server失败。在这种情况下，排除连接错误并重试连接。 ii. 如果主机信息右侧出现绿色对勾（√），表示Tuning Server可访问。

图 2.16 建立UART与Tuning Server的连接

点击“OK”完成配置。

操作结果

Tuning Server的主机地址显示在 VTunerClient 工作台的状态栏中。指示灯显示主机是否可访问。

a) 绿色指示灯表示Tuning Server可访问。
b) 红色指示灯表示Tuning Server不可访问。

图 2.17 连接状态图标

Note：需要PC与开发板在同一网段才能通信。

导入自定义传感器信息（当前环境只需要设定Input Type、Sensor Name和Sensor Mode；其他勿动）

a) 在工具栏中，点击。

在弹出的Live Preview对话框中，指定以下信息：

图 2.18 Configuring Live Video Preview

b) 从“Input Type”下拉列表中选择sensor。
c) Sensor Name选择启流或者当前调试对应的模组。传感器信息添加参考自定义传感器信息。
d) Sensor Mode选择当前模组调试对应的模式。

Note：工具需要识别当前接入模组的分辨率、曝光量限定等信息；部分模块依赖传感器信息才能具体调试；未导入传感器信息部分模块可能是置灰无法调试。

2.2 调试工作台

本节为您提供 VTunerClient 工作台用户界面 (UI) 的概述。

2.2.1 ISP Tuner视图

ISP Tuner视图包含Tuning ISP 特性所需的以下组件，如图 2.21所示。

图 2.21 ISP Tuner工具主页面

2.2.1.1 工具栏

　Import feature settings to a project.
　Export feature settings to a project.
　Capture images or videos.
　Send local raw image or video data to Tuning Server for ISP processing.
　Preview a video.
　Configure registers.
　Modify connections to Tuning Server.
　Modify preferences.
　Tune multiple parameters in a single batch.
　Provide access to extra components.

2.2.1.2 额外组件

本节介绍了 ISP Tuner视图工具栏中按钮下拉列表中可用的额外组件。

Json/Xml Edit：一个简单的 .json 或 .xml 文件编辑器。
Calibration Tool:：基于 MATLAB Runtime (MCR) 2023a 的校准工具。

要使用校准工具，MCR2023a 必须安装在与 VTunerClient 安装在同一台个人计算机 (PC) 上。有关更多详细信息，请参见 ISP 软件发行包中提供的校准工具用户指南。

校准工具仅在 Windows 上可用。

AWB Tool：一个可以可视化校准数据和统计数据的工具。

AWB工具仅在 Windows 上可用。有关 AWB 工具的详细信息，请参见2.2.1.2.1。

2.2.1.2.1 AWB Tool

自动白平衡 (AWB) 工具提供 AWB 校准数据和统计数据，例如有效白点的平均 RGB 值和每个色温范围内白点的比例。

AWB 工具从Tuning Server读取图像的校准数据和统计数据，并将数据绘制在图表上，并在表格中列出统计数据。每次点击“Update”按钮时，AWB 工具从Tuning Server读取数据并相应地刷新Dump的图像、图表和表格。

使用 AWB 工具的先决条件

• VTunerClient 已连接到Tuning Server

• 已启动获取实时数据流。

• 当前项目中可用 AWB 模块和曝光统计模块。

统计窗口块

AWB 工具提供一个窗口，用于显示Dump的图像，分为 32x32 块，对应 32x32 元素统计数据，如图 2.22所示。

图 2.22 32x32 Blocks Window

您可以选择一个块以显示其在 AWB 统计窗口中的本地信息。一次只能选择一个块。
选择后，该块将以黄色边框突出显示，如图 2.23所示。

图 2.23 Block Selection

AWB 统计窗口中对应的白点也会以黄色突出显示，如图 2.23。
您可以点击选中的块以取消选择。每个块中的数字表示 AWB 统计窗口中选择项的平均

AWB 统计窗口

AWB 工具提供一个窗口，用于显示统计数据。只有参与 AWB 统计的白点被计数。

AWB Statistic包含一个表格和一个图表。

a) 表格包括以下部分：Global, SelectZone和Weight。表格中的每个值表示相应通道的平均值。

i. Global列出整个图像的统计数据。

ii. SelectZone列出块窗口中选择的块的统计数据。如果未选择块，则选择区域部分为空

iii. Weight列出光源的权重。权重之和必须等于 1。如果所有权重均为 0，则需要确保启用了 AWB 模块。

要仅显示您感兴趣的信息，可以从Select Item下拉列表中选择一个选项。

要刷新表格和图表，可以点击“Update”按钮。但是，刷新后，之前所做的所有更改将被丢弃。

图 2.22中的画面图可以通过“Load Image”功能导入，方便参考每个统计块数据结果。

b) 下面图 2.25说明了白点和光源的分布。

如果 AWB 模块可用 confidenceThreshold 参数，您可以通过拖动光源的圆圈来调整每个光源的大小。这将更新并将新的 confidenceThreshold 发送到Tuning Server，并可能导致图像和统计信息的变化。调整光源大小时，需要注意以下约束：

i. 任何两个光源的圆圈不得相交。
ii. 调整后的圆圈大小不得小于初始大小。

图 2.24 AWB Statistic Window

2.2.1.3 视图

Button	Description
Project Explorer(2 图3.2.1)	Lists the projects in the current workspace.
Features (3 图3.2.1)	Lists the feature modules that can be tuned for the project selected in the Project Explorer view. The label of this view varies with the tuning template of the selected project.
Details (4 图3.2.1)	Shows the settings of the feature module selected in the Features view. The label of this view varies with the selected module.
Console (5 图3.2.1)	Prints logs in realtime.

表格 2.22 Views in the ISP Tuner Perspective

2.2.2 工程资源预览

工程资源视图提供当前工作区项目的分层视图，如图 2.26所示。

图 2.25 Project Explorer View

2.2.3 功能预览

功能预览显示可以Tuning的功能模块列表。

图 2.26 功能列表示例

2.2.4 模块细节

显示功能视图中选择的功能模块可用于Tuning的设置，顶部有一个控制栏。设置因不同特性而异。图 2.28显示了 3D 降噪模块的详情视图示例。

图 2.27 细节示例

2.2.4.1 控制栏

模块细节在顶部提供一个控制栏。控制栏中的按钮描述如下。

图 2.28 Example Control Bar with the Write Page Button in the Details View

图 2.29 Example Control Bar

(Undo)　撤销或重做操作。每个模块分别支持撤销/重做功能。对于每个模块，最多可以撤销和重做10次更新。注意：新更新存储在历史记录的末尾，必要时会包含中间步骤。例如，Strength的初始值为0，然后依次更改为2、4、6和8。重复单击“撤销”按钮直到该值恢复为2时，“撤销”和“重做”按钮均可用，因为我们可以回溯到0，也可以前进到4、6和8。此时，如果Strength被设置为5，则此次更新将添加到历史记录的末尾，位于中间记录8 -> 2之后。此时“重做”按钮被禁用，因为已经到达最后一步，而“撤销”按钮可以按5 -> 2 -> 8 -> 6 -> 4 -> 2 -> 0的顺序回溯。
(Redo)　撤销或重做操作。每个模块分别支持撤销/重做功能。对于每个模块，您最多可以撤销和重做10次更新。注意：新更新存储在历史记录的末尾，必要时会包含中间步骤。例如，Strength的初始值为0，然后依次更改为2、4、6和8。重复单击“撤销”按钮直到该值恢复为2时，“撤销”和“重做”按钮均可用，因为我们可以回溯到0，也可以前进到4、6和8。此时，如果Strength被设置为5，则此次更新将添加到历史记录的末尾，位于中间记录8 -> 2之后。此时“重做”按钮被禁用，因为已经到达最后一步，而“撤销”按钮可以按5 -> 2 -> 8 -> 6 -> 4 -> 2 -> 0的顺序回溯。
Save Set1　将当前视图中的参数设置保存至 asset1。
Save Set2　将当前视图中的参数设置保存至 asset2。
Load Set1　从设置 set1 加载参数设置。
Load Set2　从设置 set2 加载参数设置。
Read Page　从 Tuning Server 读取当前视图中所有参数的设置值。
Write Page　将当前视图中的所有参数设置写入 Tuning Server。
Write To Manual　将自动模式的当前值写入Tuning Server的手动参数，并切换至手动模式。

Note：“Write To Manual”功能需要在具体模块View栏中选择“Current Value View”选项，工具端才会出现Write To Manual，该功能可以用于debug问题，把当前的Auto状态下的参数写入到Manual状态，通过修改较少的Manual参数来调试和定位问题。

2.2.4.2 参数类型

参数细节支持五种类型的参数：布尔型、整数/浮点型、选项型、矩阵型和曲线型。用于设置每种参数类型的控件有所不同。

2.2.4.2.1 布尔参数

每个布尔参数通过选择或取消选择复选框进行配置，如图 2.211所示。

图 2.210 Boolean Parameter Example

2.2.4.2.2 整数/浮点参数

每个整数/浮点参数通过在文本框中输入值或拖动右侧的滑块进行配置，如图 2.212所示。一旦滑块被拖动，文本框中的值会更新，反之亦然。

支持的值范围在您将鼠标悬停在滑块上时会提示，左端点和右端点分别表示最小值和最大值。

图 2.211 Integer/Float Parameter Example

2.2.4.2.3 选项参数

每个选项参数通过从下拉列表中选择一个值进行配置，如图 2.213所示。

图 2.212 Option Parameter Example

Option: view

如果功能模块提供view选项，可以使用它在手动模式视图、自动模式视图和当前值视图之间切换，如下所示：

a) 如果选择Manual Mode View，详情视图显示手动配置参数。 b) 如果选择Auto Mode View，详情视图显示自动配置参数。 c) 如果选择Current Value View，详情视图显示模块在自动模式下插值后生效的值。

当前值视图为只读。然而，您可以点击控制栏中的“Write To Manual”按钮，将当前视图中的值分配给Tuning Server的手动参数。

图 2.213 Examples of Option view

选项：状态

如果功能模块提供state选项，可以启用或禁用模块，如下所示：

a) 如果选择Manual，模块在手动模式下工作。只有手动模式视图是可编辑的。 b) 如果选择Auto，模块在自动模式下工作。只有自动模式视图是可编辑的 c) 如果选择Off，模块被禁用

图 2.214 Example of Option state

2.2.4.2.4 数字矩阵参数

每个数字矩阵参数提供一个“View”按钮，点击后会弹出一个表格窗口，用于编辑矩阵，如图 2.216和图 2.217所示。矩阵的维度大于二，用 JSON 形式表示在表格中。

数字矩阵参数窗口包含：

a) 参数名称，也用作表格名称 b) 每个单元格的值范围

图 2.215 Matrix Parameter Example

图 2.216 Table for Editing a Matrix Parameter

　Switch between different pages of table data.
　Switch between different pages of table data.
　Import table data from a.csv file.
　Export table data to a.csv file.
　Save the updates of the table and close the window.

2.2.4.2.5 ROI 矩阵参数

每个 ROI 矩阵参数提供一个“View”按钮，点击后会弹出一个对话框，用于指定感兴趣区域 (ROI)，如图 2.218所示（新工具在右下角load YUV数据到工具端）。

a) 要添加 ROI，可以在图像中选择一个 ROI。

然后，ROI 的信息，包括坐标、宽度、高度和权重，会自动添加到右侧的表格中。

b) 要修改 ROI 的权重信息，可以双击并编辑相应的单元格。 c) 要删除选定的 ROI，可以点击相应行的“Del”按钮。 d) 要保存更新并退出，点击“OK”。

Note：预览dump导入功能还不支持，可以手动dump样图导入select Rois界面，来辅助标注ROI区域，不导入的话将会是纯白的空白图像。此功能依赖2.4.2章节传感器信息设定。

图 2.217 Window for Editing an ROI Matrix Parameter

2.2.4.2.6 颜色矩阵参数

每个颜色矩阵参数提供一个“View”按钮，点击后会弹出一个对话框，用于在灰度表中显示统计数据，如图 2.219所示。每个单元格中的数字表示统计数据，0 显示为黑色，255 显示为白色。

对于曝光统计，矩阵大小是32x32。

左上角的下拉列表提供四个选项，每个选项表示一个通道。颜色矩阵显示所选通道的统计数据。更改通道会更新颜色矩阵，这可能需要一些时间。

图 2.218 Example of Color Matrix Window

2.2.4.2.7 曲线参数

每个曲线参数通过使用折线图和二维矩阵表进行配置，如图 2.220所示。每个表格行指定图表上的一个控制点的坐标。可以通过拖动折线图上的控制点或修改矩阵表中的坐标来编辑矩阵。控制点的数量是可配置的，范围从 3 到曲线上实际点的数量。

Note：控制点用于配置曲线。修改控制点数量不会改变曲线上实际点的数量。折线图显示控制点而非实际点，以便于配置。

每条曲线可以从导入的 .csv 文件生成。曲线控制点的 Y 值可以导出到 .csv 文件。

图 2.219 Curve Parameter Example

对于自动模式下的曲线参数，表格上方提供一个曲线索引选项，如图 2.221所示。曲线索引选项控制应用于曲线的增益。可以选择一个索引在不同增益之间切换曲线，然后进一步编辑矩阵。

图 2.220 Example of Curve Parameter in Auto Mode

折线图上方的工具栏

　Configure the appearance of the line chart, as shown in图 2.222 to 图 2.223.
　Toggle whether to show the legend when the legend is available.
　Add and remove annotations on the chart. For example annotations, see 图 2.224.
　Perform auto-scale and zoom operations.
　Pan the line chart.
　Exit the auto-scale, zoom, or pan function that is previously active.
　Undo and redo previous operations.
　Save a snapshot to a .png file.

图 2.221 Configure Graph Settings > Graph&Axes

图 2.222 Configure Graph Settings > Traces&Annotation

图 2.223 Annotation Examples

2.2.4.2.8 文件参数

每个文件参数提供一个“Load File”按钮，点击后会弹出一个对话框，用于加载由校准工具生成的 .txt 文件。

Note：如果在启动流之后加载 .txt 校准文件，校准数据可能不会生效。因此，建议在加载 .json 校准文件后，启动流之前导入 .txt 校准文件。有关如何加载 .json 校准文件的信息，请参见2.3.1.2。

图 2.224 File Parameter Example

2.2.5 控制台视图

控制台视图显示 VTunerClient 和Tuning Server之间的所有交互消息以及运行时错误和警告消息，如图 2.226所示。

图 2.225 Console View Example

2.3 Tuning解决方案 – 弱参考

本节指导您如何使用 VTunerClient 对运行在开发板和仿真器上的一些调试方法。

2.3.1 导出和导入功能模块设置

2.3.1.1 从ISP工程导出调试参数

先决条件

• VTunerClient 工作台显示在 ISP Tuner视图。有关说明，请参见第 2.2 节。

• 在Project Explorer中选择了一个 ISP 项目。有关如何创建 ISP 项目的信息，请参见第 2.1.3 节。

• VTunerClient 已连接到Tuning Server。有关说明，请参见第 2.1.4 节。

• 已启动 ISP 数据流。有关说明，请参见第 2.3.2 节。

操作过程

1，在工具栏中，点击。 2，在弹出的保存对话框中，选择保存文件的目标目录，命名文件，然后点击“Save”。

图 2.31 Specifying the Location and Name of an Exported File

3， Export对话框在导出过程中显示。然后，导出是否成功的信息会在对话框中提示。

图 2.32 Export Dialog

操作结果

在指定目录中创建包含模块调试设置和校准设置的 .json 文件。

后续步骤

您可以按照第 2.3.1.2 节的说明，将导出的文件参数导入到 ISP project。

2.3.1.2 导入调试参数到 ISP 项目

本节将特性模块设置或校准设置从 .json 文件导入到Tuning Server。

先决条件

• VTunerClient 工作台显示在 ISP Tuning视图。有关说明，请参见第0。

• SDK中的 .json 默认Tuning文件和 Calibration tool生成的.json 校准文件可用于导入。或者按照第2.3.1.1节导出并根据需要编辑后的文件可用于导入。

• 在项目资源浏览视图中选择一个 ISP 项目。有关如何创建 ISP 项目的信息，请参见第 2.1.3 节。

• VTunerClient 已连接到Tuning Server。有关说明，请参见第 2.1.4 节。

操作步骤

1，在工具栏中，点击。 2，在弹出的打开窗口中，选择要导入的 .json 文件，然后点击“OK”。

图 2.33 Selecting a JSON File

导入过程会显示导入对话框在。然后，导入是否成功的信息会在对话框中提示。

图 2.34 Import Dialog

结果

• 当前 ISP 项目已使用导入文件中的特性模块设置进行更新。

• 导入文件中的特性模块设置已同步到Tuning Server。然后，VTunerClient 工作台会更新Tuning Server端使用的设置。

2.3.2 将原始图像注入Tuning Server

本节工具在X5平台上暂不支持。

2.3.3 Feature Module调试

本节主要介绍调试 ISP 的Feature Module参数。

先决条件

VTunerClient 工作台显示在 ISP Tuning视图。有关说明，请参见第 2.1.2 节。
在项目资源浏览视图中选择了一个 ISP 项目。有关如何创建 ISP 项目的信息，请参见第 2.1.3 节。
VTunerClient 已连接到Tuning Server。有关说明，请参见第 2.1.4 节。
ISP pipeline被启动和初始化。详细请参考第2.3.2节。

配置步骤

1，在如下图Features预览中，选择您想要调整的feature module。

然后，该模块的相应参数将在详细信息视图中显示。

2，在详细信息视图中，根据第2.2.4.2节，参数类型中的说明配置模块。

默认情况下，当切换到另一个模块时，VTunerClient会自动从Tuning Server读取数据。重新建立连接后，您需要在控制栏点击“Read Page”以手动进行数据同步。此外，导入一个.json文件后，当前视图将自动更新为从server读取的数据。

3，点击“Write Page”将当前的参数设置写入到Tuning Server。

如果偏好设置中的自动数据写入复选框被选中，此步骤可以跳过。有关详细信息，请参见第2.3.6节，配置偏好设置。

操作结果

ISP 的输出视频或图像根据调整的模块参数进行更新。

2.3.4 编辑寄存器

本节介绍如何进行 ISP 的寄存器设置。

先决条件

VTunerClient 工作台显示在 ISP Tuner视图。有关说明，请参见第 2.1.2 节。
在Project Explorer视图中选择了一个 ISP 项目。有关如何创建 ISP 项目的信息，请参见第 2.1.3 节。
VTunerClient 已连接到Tuning Server。有关说明，请参见第 2.1.4 节。
ISP pipeline被启动和初始化。详细请参考第2.3.2节，”配置实时预览”。

操作步骤

1，在工具栏中，点击。

然后，寄存器的Edit Register页面就会出现

图 2.37 Edit Register

● 重要提示：设置必须完全遵循硬件发布包中提供的软件可访问寄存器文档中列出的要求

2，在“Address”文本框中，输入要编辑的目标寄存器的地址。 3，从“Type”下拉列表中，选择是编辑ISP寄存器还是传感器寄存器。 4，如果要编辑连续的寄存器，请选择“Sequence”复选框。 5，如果选择了“Sequence”复选框，请输入从指定地址开始要编辑的连续寄存器的数量。 6，在“Value”文本框中，输入寄存器的新值，或者为右侧每个寄存器位选择或清除相应的复选框。 7，点击“Add”将寄存器设置添加到表中。如果地址未指定或已存在于表中，则添加失败。

或者，点击Export将表导出到.csv文件，编辑该文件，然后点击“Import”进行导入。

8，（可选）在表中，选择一条记录，然后点击“Delete”将其从表中删除。 9，（可选）重复步骤2至步骤8，编辑表格以包含所有必需的寄存器设置。 10，点击“Write”以使用表中的所有寄存器设置更新Tuning Server。要查询表中寄存器的值，请点击“Read”。查询结果将覆盖表中的“VALUE”列。

操作结果

ISP 的寄存器设置根据输入的值进行更新。

2.3.5 Dump图像

本节介绍如何从 ISP Dump图像或视频。

先决条件

Hbplayer工具已经显示出图。详细参考2.1.2 节
在Project Explorer视图中选择了一个 ISP 项目。有关如何创建 ISP 项目的信息，请参见第 2.1.3 节。
VTunerClient 已连接到Tuning Server。有关说明，请参见第 2.1.4 节。
ISP pipeline被启动和初始化。详细请参考第2.3.2节，”配置实时预览”。

操作步骤

1，打开Hbplayer预览界面 2，点击页面图 2.38区域，可以实现YUV/BPM/jpg数据的dump。

图 2.38 Hbplayer dump image

3， Dump完成后默认在Hbplayer根目录下面/dump文件夹，下面会有抓取的对应数据（建议手动指定Dump路径）。

2.3.6 配置首选项

本节介绍如何配置 VTunerClient 的首选项。

先决条件

确保 VTunerClient 工作台已经接入服务并连接板端。

操作步骤

1，在工具栏中，点击。

会出现以下页面

图 2.39 Configuring Preferences

2，选择或清除“Automatically read data when switching pages”，以控制是否在切换页面时自动从Tuning Server读取数据，并用读取的数据更新参数信息。 3，选择或清除“Automatically write data when modify parameter”，以控制是否在调整参数模块时自动将数据写入Tuning Server。 4，点击“OK”。

2.3.7 批量Tuning

本节功能X5暂不支持。

2.4 自定义配置

2.4.1 定义VTunerClient中显示的模块和参数

本节介绍如何自定义 VTunerClient 的配置以适应特定需求。

先决条件

确保 VTunerClient 工作台连接在板端。有关说明，请参见第 2.1.2 节。

操作步骤

1，（推荐）备份工作目录中的isp_modules.json文件。

2，打开并编辑isp_modules.json文件以便（一般不建议用户修改）：

a) 移除某些模块或参数。

b) 修改模块或参数的显示顺序。

c) 修改模块、组或参数的显示名称。

d) 将一些参数组合成一个新的模块。

e) 与Tuning Server协作添加模块或参数。

图 2.41 isp_modules.json Example

在isp_modules.json文件中：

a) moduleName定义了模块的名称。

b) paramGroups包括一个数组，其中每一项定义一个参数组。

c) params包括一个数组，其中每一项在组内定义一组参数。

d) label是工作台中显示的参数名称。如果没有指定label，则工作台将显示key的值。

e) type定义了参数的类型。

有关更多信息，请参见第2.2.4.2节，参数类型。

3，删除并重新创建现有项目以激活自定义设置。

操作结果

功能模块中的Features列表以及每个参数模块详细信息可根据自定义更新。

2.4.2 自定义传感器信息

本节介绍编辑工作区中的isp_sensor.json文件，以自定义包括传感器名称和传感器模式在内的传感器信息，用于第2.3.2节中实时预览配置。

先决条件

确保已按照第2.1.2节，启动VTunerClient工作台的说明创建了工作区。

操作过程

1，（推荐）备份工作目录中的isp_sensor.json文件。 2，打开并编辑isp_sensor.json文件。

在isp_sensor.json文件中：

a) sensorName定义了传感器的名称。建议使用与Tuning Server端相同的传感器名称。

b) Mode包括一个数组，其中每一项定义一个传感器模式。

c) af表示传感器是否支持PDAF或CDAF模块。

d) bayerPattern表示输出的Bayer模式。

e) bitWidth表示输出格式的位深度。

f) fps表示输出的帧率。

g) hdr表示线性/HDR模式。有效值：Linear、Native HDR和Stitch HDR。

h) size表示以像素为单位的输出分辨率。

i) integrationTime表示曝光一定行数所需的时间，以微秒为单位。测量的行数取决于传感器配置。

j) aGain表示模拟增益。

k) dGain表示数字增益。

图 2.42 isp_sensor.json Example

操作结果

根据自定义，传感器名称和传感器模式下拉列表中的选项将被更新。

Note：以上设定需要在每次启动VtuneClient工具链接Server后，Input Type选择sensor，SensorName选择正确的已添加sensor。这决定跟驱动交互信息的限定和正确性。AE Manual控制以及ROI window的设定都依赖此部分设置；如果更换Vtuner工具版本，工作目录下的文件会被backup，可以在新版本安装前备份isp_sensor.json文件

5.17.10.4. 附录A

Term	Description
AWB	Auto White Balance
FPGA	Field-Programmable Gate Array
FPS	Frames Per Second
GUI	Graphical User Interface
HDR	High Dynamic Range
HTTP	Hypertext Transfer Protocol
HW	Hardware
ISP	Image Signal Processing
OS	Operating System
PC	Personal Computer
PQ	Picture Quality
SDK	Software Development Kit
SW	Software
TCP	Transmission Control Protocol
UART	Universal Asynchronous Receiver-Transmitter
UI	User Interface
URL	Uniform Resource Locator

表格 2.41 术语