# K230 ISP Tuning Tool使用指南 ## 模块软件架构 ![arch](images/28a799580bb5670cb8d29dc709a4dcc6.png) 图1-1 ## Tuning Tool的连接及启用 ### 工具获取路径 | **文件名** | **存放位置** | **功能** | |-----------------|--------------------|-----------------------------------------------------| | PC tuning-tool软件包（K230 ISP Tuning Tool.exe） | relaese的源码包k230_sdk/tools/tuning-tool-client/K230_ISP_Tuning_Tool_20240129.7z | 用于图像dump，ISP调试等PC端工具 | | t_server_c-6.1.0 | 小核文件系统 /mnt/ | tuning server可执行程序 | | sample_sys_init.elf | 大核文件系统 /sdcard/app | 大核服务端 | ### 启动流程 1. 板端小核配置IP 1. 板端小核等待sharefs启动后，在大核启动 sample_sys_init.elf，运行 `/sharefs/app/sample_sys_init.elf` 即可 1. 板端小核启动tuning server，运行 `/mnt/t_server_c-6.1.0`，需要根据实际情况添加参数，使用 `-?` 参数查看帮助 1. PC端启动tuning tool，连接K230 ## Tuning Tool界面介绍 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/01.png) 图3-1 如图3-1所示为tuning tool的基本操作UI全部展开后共六个区域： (1) 菜单操作区域：文件操作、窗口管理等功能 (2) 工具栏区域：支持关键功能的操作 | 按钮 | 描述| |------|------------------------------------------------------------| | ![Graphical User Interface,Text,Application,Email Description is automatically generated](images/11.png) | 将设置导出到文件| | ![Graphical User Interface,Text,Application,Email Description is automatically generated](images/12.png) | 从文件导入设置| | ![Graphical User Interface,Text,Application,Email Description is automatically generated](images/10.png) | 拍摄图像或视频| | ![Graphical User Interface,Text,Application,Email Description is automatically generated](images/13.png) | 将本地raw图像或视频发送到调试服务器由ISP处理| | ![Graphical User Interface,Text,Application,Email Description is automatically generated](images/09.png) | 视频预览| | ![Graphical User Interface,Text,Application,Email Description is automatically generated](images/14.png) | 配置寄存器| | ![Graphical User Interface,Text,Application,Email Description is automatically generated](images/02.png) | 配置连接调试服务器| | ![Graphical User Interface,Text,Application,Email Description is automatically generated](images/15.png) | 修改首选项| | ![Graphical User Interface,Text,Application,Email Description is automatically generated](images/19.png) | 在一个批次中调整多个参数| | ![Graphical User Interface,Text,Application,Email Description is automatically generated](images/16.png) | 提供对额外组件的访问| (3) 工程管理区域：选择和管理不同工程 (4) 功能区域：用于ISP各模块UI的切换 (5) 调试区域：用于调试某一个模块的参数 (6) 回显区域：用于打印部分参数下发和接收的日志 ### 连接板端tuning-server #### 使用HTTP方式连接板端tuning-server SDK默认支持HTTP方式连接，点击工具栏中的配置连接调试服务器按钮![图形用户界面, 文本, 应用程序 描述已自动生成](images/02.png)，将弹出图3-2。 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/03.png) 图3-2 选择HTTP模式，保证PC与板端连接的网络处于同一网段，在“Host”输入框中输入板端的IP，在“Port”输入框中请输入固定端口34567，配置完成后点击“OK”按钮，如果板端tuning-server已经启动，则会自动完成连接。任意切换图3-1中④区域的模块，则会看到tuning-server端的函数打印。 ### 创建/选择工程 若所需调试的工程已在图3-1中③区域，则点击选中该工程即可开始ISP调试。 若还没有创建所需调试的工程，则需先创建该工程。 #### 创建调试工程 如图3-3，依次点击File-\>New-\>Project...，弹出工程创建向导窗口，如图3-4。 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/New_Project_01.png) 图3-3 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/New_Project_02.png) 图3-4 点击“ISP”目录，显示出“ISP Project Wizard”, 单击“ISP Project Wizard”后，再点击“Next”按钮，弹出创建工程窗口，如图3-5。 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/06.png) 图3-5 输入工程名称，指定工程地址后，点击“Finish”按钮即可完成工程创建，该工程将显示在图3-1中的区域③。点击该工程即可开始ISP调试。 ### 在线调试界面及功能描述 本节只是简单介绍一些tuning tool界面上调试模块的主要功能，具体的调试策略及步骤在图像调优文档中进行详细的描述。 ISP功能模块如图3-6所示。 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/07.png) 图3-6 #### Bypass Settings 所有ISP功能模块的使能控制。 #### Auto Focus Control (Focus Control) 聚焦控制调试模块。 当选择auto mode时（Auto Mode View)，界面列表中显示为自动聚焦控制(Auto Focus Control); 当选择manual mode时（Manual Mode View），界面列表中显示为聚焦控制（Focus Control）。 #### Auto Exposure Control (Exposure Control) 曝光控制调试模块。 当选择auto mode时（Auto Mode View)，界面列表中显示为自动曝光控制(Auto Exposure Control); 当选择manual mode时（Manual Mode View），界面列表中显示为曝光控制（Exposure Control）。 自动曝光控制参数，控制图像亮度和AE调节时的收敛速度等。 支持设置ROI窗口。开启ROI模式需要，需要semMode中选择FIX模式并enable AE才能开启ROI模式。 #### Auto White Balance (White Balance) 白平衡控制调试模块。 当选择auto mode时（Auto Mode View)，界面列表中显示为自动曝光控制(Auto White Balance); 当选择manual mode时（Manual Mode View），界面列表中显示为曝光控制（White Balance）。 #### Exposure Statics 暂未支持。 #### Auto Focus Measurement 暂未支持。 #### High Dynamic Range 多曝光宽动态，可调节各曝光间的曝光量比例系数、融合取值范围。 #### Compand 数据拉伸、压缩模块，可设置作用曲线。 #### Black Level Subtraction 提供与Sensor相关的黑电平校正，可对R、Gr、Gb、B四通道进行设置。 #### RGB Infrared Radiation 暂未支持。 #### Lens Shading Correction 提供镜头阴影校正，校准系数由标定工具生成。 #### Digital Gain 用于对ISP Digital Gain使能控制及调节大小。 #### Wide Dynamic Range 提供对图像全局和局部对比度的调整。 #### Green Equilibrate 校准Gr与Gb两通道的不平衡，可设置不同的绿平衡强度。 #### Defect Pixel Cluster Correction 提供对像素坏点的检测及校准的功能，通过选择set可设置不同的校准方法。 #### DeNoising Prefilter 双边滤波降噪模块。 #### D Noise Reduction 通过调整参数配置，对图像降噪强度的调节。 #### Demosaic 通过插值将Bayer格式的Raw图转为RGB图，并提供去摩尔纹、去紫边、锐化及降噪处理功能。 该模块中还包含了CAC子模块，用于校准主要由镜头引入的色差，由标定工具生成校准参数。 #### Color Correction Matrix 色彩还原矩阵。通过调节3x3 CCM矩阵及偏移量可完成颜色偏差的校准。 #### Gamma Correction 支持客户自定义gamma，该模式下可更改gamma指数。 #### Edge Enhance 用于提升图像的清晰度。通过设置合适的参数，提升图像清晰度的同时，也可抑制噪声的增强。 该模块中还包含了CA和DCI两个子模块。 CA模块用于调节图像的饱和度。根据图像亮度或者原饱和度的变化来调整饱和度，达到局部调整饱和度的目的，让亮区域的颜色更鲜艳以及消除暗区域或低饱和度区域的彩噪。 DCI模块实现对图像的动态对比度调整。 #### Color Processing 颜色处理模块，可调节图像的对比度、亮度、饱和度及色调，设置不同的颜色喜好或风格。 ### 拍摄图像 #### 设置图像格式和大小 点击工具栏中的预览按钮![图形用户界面, 文本, 应用程序 描述已自动生成](images/09.png)，将弹出图3-7。 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/08.png) 图3-7 勾选“Stream Enable”。在“Output Format”栏中选择需拍摄的图像格式： 若需拍摄YUV图像，当前仅支持8bit yuvNV12格式数据，请选择“YUV420 Semi_Planar”； 若需拍摄raw data图像，请根据ISP接入的raw data位宽选择相应位宽选项。 如下图3-8，在“Output Size”栏中正确设置图像大小。 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/17.png) 图3-8 点击“OK”按钮完成设置。 #### 采集图像 点击工具栏中的拍摄按钮![图形用户界面, 文本, 应用程序 描述已自动生成](images/10.png)，将弹出图3-9。 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/18.png) 图3-9 在“Save Path”栏中选择图像文件保存的地址。 若拍摄单帧图像，直接点击“Capture”按钮即可； 若拍摄多帧图像，请在“Snapshot Num”选项中设置所需拍摄的帧数，并根据所希望输出的文件数量设置“Output as One File”选项（勾选或不勾选），完成上述配置后，点击“Capture”按钮开始拍摄。 ### 参数的导入与导出 #### 参数导入 工具默认支持导入的参数文件为标准xml和json格式，分为标定参数和tuning参数两部分，支持PC本地导入。 点击工具栏中的导入按钮![图形用户界面, 文本, 应用程序 描述已自动生成](images/12.png)，将弹出图3-10。 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/import.png) 图3-10 在图3-10所示窗口中选择需要导入的xml或json参数文件，点击“Open”按钮即可开始导入。 #### 参数导出 工具默认导出方式会将在线调试参数汇总为一个json文件存放。 点击工具栏中的导出按钮![图形用户界面, 文本, 应用程序 描述已自动生成](images/11.png)，将弹出图3-11。 ![图形用户界面, 文本, 应用程序, 电子邮件 描述已自动生成](images/export.png) 图3-11 在图3-11所示窗口中选择需要导出的json参数文件，点击“Save”按钮即可开始导出。