中文 EN

5.17. 图像质量调试指南

• 5.17.1. 概述
• 5.17.2. Camera 调试指南
  • 5.17.2.1. 范围
  • 5.17.2.2. 文档组成
  • 5.17.2.3. 准备工作
  • 5.17.2.4. 新 sensor 点亮步骤
  • 5.17.2.5. 修改平台设备树 (dts)
    • 1. sensor GPIO 配置
    • 2. sensor I2C 配置
    • 3. sensor MCLK 配置
    • 4. sensor LPWM 配置
    • 5. dts 验证
  • 5.17.2.6. 添加 sensor 驱动代码
    • 驱动位置与命名
    • sensor_module_t 接口
    • 关键概念
    • Gain LUT 表 生成方式
    • 驱动部署流程
  • 5.17.2.7. 添加 camera App 代码
    • vp_sensor_config_t 配置项
  • 5.17.2.8. 添加默认 camera ISP 效果库
  • 5.17.2.9. 板端示例程序运行
  • 5.17.2.10. ISP 图像调试预览与 2A 验证
  • 5.17.2.11. 小结
• 5.17.3. OmniVision Sensor Bring-Up
  • 5.17.3.1. dts配置
  • 5.17.3.2. 驱动
    • sensor_module_t 与文件命名
    • power_on
    • power_off
    • init
    • deinit
    • start
    • stop
    • ISP 配置与 linear_data_init
    • aexp_line_control
    • aexp_gain_control:
    • userspace_control
    • 驱动部署
  • 5.17.3.3. App 配置
    • vp_sensor 配置文件：linear_3840x2160_raw10_30fps_2lane.c
  • 5.17.3.4. 程序验证
• 5.17.4. SmartSens Sensor Bring-Up
  • 5.17.4.1. dts配置
  • 5.17.4.2. 驱动
    • sensor_module_t 与文件命名
    • power_on
    • power_off
    • init
    • deinit
    • start
    • stop
    • ISP 配置与 linear_data_init
    • aexp_gain_control
    • aexp_line_control
    • userspace_control
    • 驱动部署
  • 5.17.4.3. App 配置
    • vp_sensor 配置文件：linear_1088x1280_raw10_60fps_1lane.c
  • 5.17.4.4. 程序验证
• 5.17.5. Sony Sensor Bring-Up
  • 5.17.5.1. dts配置
  • 5.17.5.2. 驱动
    • sensor_module_t 与文件命名
    • power_on
    • power_off
    • init
    • deinit
    • start
    • stop
    • ISP 配置与 linear_data_init
    • aexp_gain_control
    • aexp_line_control
    • userspace_control
    • 驱动部署
  • 5.17.5.3. App 配置
    • vp_sensor 配置文件：linear_3840x2160_raw10_30fps_4lane.c
  • 5.17.5.4. 程序验证
• 5.17.6. HDR Sensor Bring-Up
  • 5.17.6.1. dts配置
  • 5.17.6.2. 驱动
    • sensor_module_t 与文件命名
    • power_on
    • power_off
    • init
    • deinit
    • start
    • stop
    • ISP 配置与 dol2_data_init
    • aexp_gain_control
    • aexp_line_control
    • userspace_control
    • 驱动部署
  • 5.17.6.3. App 配置
    • vp_sensor 配置文件：dol2_3840x2160_raw10_30fps_4lane.c
      • MIPI 配置
      • Camera 配置
      • VIN 配置
      • ISP 配置
      • 完整参数汇总
  • 5.17.6.4. 程序验证
• 5.17.7. Camera 调试FAQ
  • 5.17.7.1. FAQ
    • 目录
  • 5.17.7.2. I2C
    • i2c 不通
  • 5.17.7.3. MCLK
    • 如何修改 MCLK 驱动电流
    • 查看 mclk 频率和使能的状态
  • 5.17.7.4. MIPI
    • 无法进入 HS，MIPI start error
    • MIPI 报错
    • MIPI 参数确定
      • Framelength (VTS)
      • Linelength (HTS)
      • MIPI CLK
      • Settle
    • 如何修改 MIPI 驱动电流
    • 如何查看 HOST(RX) 设备当前运行状态和配置
    • 如何查看 HOST(RX) 设备寄存器
    • 如何配置同一个 HOST RX 多 VC sensor 模组
    • 如何打开 MIPI 驱动的 log
  • 5.17.7.5. Sensor
    • Sensor 库 check 或 load error
    • Sensor 作为 slave mode 配置
    • 如何配置 yuv sensor ?
  • 5.17.7.6. 图像
    • Dump 出的图带竖条纹问题
  • 5.17.7.7. gain 索引值和 增益倍率 对照表
  • 5.17.7.8. VTunerClient
    • 连接VTunerClient
    • 如何使用 VTunerClient 验证 2A
• 5.17.8. ISP 图像效果调试指引
  • 5.17.8.1. 修订记录
  • 5.17.8.2. 1 X5 ISP 介绍
    • 1.1 功能简介
    • 1.2 ISP Pipeline
  • 5.17.8.3. 2 ISP调试概览
    • 2.1 调试流程
      • 2.1.1 调试依赖设备
      • 2.1.2 调试阶段
        • 2.1.2.1 第一阶段 – 客观标定部分
        • 2.1.2.2 第二部分 – 板端部署模块优化
        • 2.1.2.3 第三部分 – 场景权衡调试
      • 2.1.3 调试模式
        • 2.1.3.1 SDR模式（linear）
        • 2.1.3.2 HDR模式
    • 2.2 ISP调试的系统需求和准备
      • 2.2.1 调试依赖信息
      • 2.2.2 Sensor 配置信息
      • 2.2.3 模组性能情况
      • 2.2.4 ISP相关参数
      • 2.2.5 调试工具（Calibration Tool/VTunerClient/HBplayer）
        • 2.2.5.1 Calibration Tool
        • 2.2.5.2 VTunerClient
      • 2.2.6 Hbplayer
  • 5.17.8.4. 3 ISP调试模块
    • 3.1 Auto-Exposure (AE)
      • 3.1.1 功能描述
      • 3.1.2 关键参数与功能说明
        • 3.1.2.1 AE使能设定
        • 3.1.2.2 Anti-Flicker
        • 3.1.2.3 AE Target设定
        • 3.1.2.4 统计和测光模式
        • 3.1.2.5 自适应AE设定
        • 3.1.2.6 目标亮度场景联动设定
        • 3.1.2.7 运动检测设定
        • 3.1.2.8 AE收敛控制
        • 3.1.2.9 AE锁定和解锁设定
        • 3.1.2.10 曝光梯度设定
        • 3.1.2.11 AE计算方式设定
      • 3.1.3 调试流程
        • 3.1.3.1 第一阶段
        • 3.1.3.2 第二阶段
        • 3.1.3.3 第三阶段
    • 3.2 Auto-White Balance (AWB)
      • 3.2.1 功能描述
      • 3.2.2 关键参数与功能说明
        • 3.2.2.1 AWB基础参数
        • 3.2.2.2 AWB模式选择
        • 3.2.2.3 纯色校正
          • 3.2.2.3.1 纯绿色校正
          • 3.2.2.3.2 纯黄色校正
          • 3.2.2.3.3 纯蓝色校正
        • 3.2.2.4 光源概率调整
        • 3.2.2.5 颜色偏好
        • 3.2.2.6 色温偏好设定
        • 3.2.2.7 Face AWB
        • 3.2.2.8 ROI AWB
        • 3.2.2.9 AWB收敛
        • 3.2.2.10 AWB锁定和解锁阈值
        • 3.2.2.11 AWB性能参数设定
      • 3.2.3 调试流程
        • 3.2.3.1 第一阶段
          • 3.2.3.1.1 调试校验
        • 3.2.3.2 第三阶段
    • 3.3 High Dynamic Range（2DOL）
      • 3.3.1 功能描述
      • 3.3.2 关键参数
      • 3.3.2 调试流程
    • 3.4 Compand
      • 3.4.1 功能描述
      • 3.4.2 关键参数
      • 3.4.3 调试流程
      • 3.4.4 调试建议与功能说明
    • 3.5 BLS(Black Level Subtraction)
      • 3.5.1 功能描述
      • 3.5.2 关键参数
      • 3.5.3 调试建议与功能说明
    • 3.6 RGBIR
      • 3.6.1 功能描述
      • 3.6.2 关键参数
      • 3.6.3 调试流程
      • 3.6.4 调试建议与功能说明
    • 3.7 Lens Shading Correction
      • 3.7.1 功能描述
      • 3.7.2 关键参数
      • 3.7.3 调试流程
      • 3.7.4 调试建议与功能说明
    • 3.8 DG(Digital Gain)
      • 3.8.1 功能描述
      • 3.8.2 关键参数
      • 3.8.3 调试建议与功能说明
    • 3.9 WDR
      • 3.9.1 功能描述
      • 3.9.2 关键参数
      • 3.9.3 调试流程
      • 3.9.4 调试建议与功能说明
    • 3.10 GE (Green Equalization)
      • 3.10.1 功能描述
      • 3.10.2 关键参数
      • 3.10.3 调试流程
      • 3.10.4 调试建议与功能说明
    • 3.11 DPCC(Defect Pixel Cluster Correction)
      • 3.11.1 功能描述
      • 3.11.2 关键参数
      • 3.11.3 调试流程
    • 3.12 Bayer NR(3DNR&2DNR)
      • 3.12.1 功能描述
        • 3.12.1.1 3DNR
        • 3.12.1.2 2DNR
      • 3.12.2 关键参数
        • 3.12.2.1 3DNR 参数
        • 3.12.2.2 2DNR 参数
      • 3.12.3 调试流程
        • 3.12.3.1 3DNR 调试
        • 3.12.3.2 2DNR 调试
      • 3.12.4 调试建议与功能说明
    • 3.13 DMSC(Demosaic)
      • 3.13.1 功能描述
      • 3.13.2 关键参数
      • 3.13.3 调试流程
    • 3.14 Color Correction Matrix（CCM）
      • 3.14.1 功能描述
      • 3.14.2 关键参数
      • 3.14.3 调试流程
        • 3.14.3.1 第二阶段
        • 3.14.3.2 第三阶段
    • 3.15 Gamma Correction
      • 3.15.1 功能描述
      • 3.15.2 关键参数
      • 3.15.3 调试流程
        • 3.15.3.1 第一阶段
        • 3.15.3.2 第三阶段
    • 3.16 EE(Edge Enhancement)
      • 3.16.1 功能描述
      • 3.16.2 关键参数
      • 3.16.3 调试流程
      • 3.16.4 调试建议与功能说明
        • 3.16.4.1 调试建议
        • 3.16.4.2 功能说明
    • 3.17 Color Processing
      • 3.17.1 功能描述
      • 3.17.2 关键参数
      • 3.17.3 调试建议与功能说明
      • 3.17.4 示例结果
    • 3.18 CNR(Chrominance Noise Reduction)
      • 3.18.1 功能描述
      • 3.18.2 关键参数
      • 3.18.3 调试流程
      • 3.18.4 调试建议与功能说明
    • 3.19 Auto Focus(AF)
      • 3.19.1 功能描述
      • 3.19.2 关键参数与功能说明
        • 3.19.2.1 AF基础调试
        • 3.19.2.2 AF模式选择
        • 3.19.2.3 AF解锁条件
        • 3.19.2.4 AF运动检测
        • 3.19.2.5 AF硬件统计
        • 3.19.2.6 PDAF统计计算
        • 3.19.2.7 PDAF 聚焦设定
        • 3.19.2.8 PDAF 搜索设定
        • 3.19.2.9 CDAF算法设定
        • 3.19.2.10 混合对焦设定
      • 3.19.3 调试流程
• 5.17.9. Calibration tool 工具指南
  • 5.17.9.1. 修订记录
  • 5.17.9.2. 1 X5 ISP校准工具概述
    • 1.1 ISP校准工具组成
    • 1.2 操作系统兼容性
    • 1.3 环境要求
  • 5.17.9.3. 2 安装与启动
    • 2.1 校准工具安装与启动
  • 5.17.9.4. 3 校准主流程
  • 5.17.9.5. 4 黑电平校正
    • 4.1 黑电平校准原始图像拍摄
    • 4.2 使用黑电平校正工具
    • 4.3 Load Data
    • 4.4 曲线
    • 4.5 预处理
      • 4.5.1 Pre-Processing PD RAW Images
      • 4.5.2 Pre-Processing RGBIR Raw Images
  • 5.17.9.6. 5 Lens Shading校正工具
    • 5.1 Lens Shading校正原始图像拍摄
      • 5.1.1 原始图像拍摄设置
    • 5.2 使用Lens Shading校正工具
    • 5.3 加载图像
    • 5.4 RGB Pattern选择
    • 5.5 CCT
    • 5.6 继承BLC基本信息（建议方式）
    • 5.7 校正方法
    • 5.8 Offset扣除
    • 5.9 节点位置（建议默认）
      • 5.9.1 自动定位初始点（建议默认）
      • 5.9.2 优化节点位置（建议默认）
      • 5.9.3 ALSC Uniform Grid（建议默认）
    • 5.10 双线性样条拟合（建议默认）
    • 5.11 比例最大值
    • 5.12 光衰减（建议默认）
    • 5.13 颜色阴影校正
    • 5.14 Gr Gain = Gb Gain
    • 5.15 MLSC Fish Eye
      • 5.15.1 Correcting Fish Lens
    • 5.16 启动选项
    • 5.17 将LSC应用于图像
    • 5.18 RTL中的精度（建议默认）
    • 5.19 Open Image in Window
    • 5.20 Save Image to File
    • 5.21 LSC工具的示例输出
  • 5.17.9.7. 6 Color Calibration
    • 6.1 色彩校准-原始图像拍摄
      • 6.1.1 设置 ColorChecker
      • 6.1.2 X5 ISP的配置
    • 6.2 使用色彩校准工具
    • 6.3 加载
      • 6.3.1 加载Lab-Customer参考（使用频率低）
      • 6.3.2 加载sRGB参考文件
      • 6.3.3 加载Color Checker图像
      • 6.3.4 加载背景图像（不要求）
      • 6.3.5 加载参考图像（不要求）
    • 6.4 LSC（建议）
    • 6.5 （可选）继承LSC信息
    • 6.6 锚点选择
    • 6.7 功能
      • 6.7.1 选择ROI、选择Self-ROI和选择Multi-ROI
      • 6.7.2 （可选）应用WB CCM（保持默认）
      • 6.7.3 选择参考白平衡（保持默认）
    • 6.8 校准
    • 6.9 保存参数
    • 6.10 保存图像菜单
  • 5.17.9.8. 7 自动白平衡工具
    • 7.1 总体工作流程
    • 7.2 拍摄AWB原始图像
    • 7.3 运行Step 1
      • 7.3.1 照明光谱分布文件（非必要）
        • 7.3.1.1 文件格式
        • 7.3.1.2 照明条件
        • 7.3.1.3 测量照明或CIE照明
      • 7.3.2 正确AWB操作的光源（保持默认）
      • 7.3.3 tau1和tau2值（保持默认）
    • 7.4 运行Step 2
      • 7.4.1 定义增益限
      • 7.4.2 修改多边形形状
      • 7.4.3 调整其他软件参数
        • 7.4.3.1 增益修改器示例设置
      • 7.4.4 （建议）调优多边形ROI区域
        • 7.4.4.1 选择图像评估白点
        • 7.4.4.2 手动修改Gain Polygon形状
    • 7.5 保存校准数据
    • 7.6 检查现有校准数据
  • 5.17.9.9. 8 噪声校准工具（非必要）
    • 8.1 噪声校准原始图像拍摄
    • 8.2 使用噪声校准工具
  • 5.17.9.10. 9 色差校正工具
    • 9.1 色差校正原始图像拍摄
    • 9.2 使用色差校正工具
    • 9.3 菜单栏
      • 9.3.1 加载图像
      • 9.3.2 加载设置
      • 9.3.3 保存设置
    • 9.4 块选择
      • 9.4.1 图像输入部分
      • 9.4.2 LSC部分（建议设定）
      • 9.4.3 色差估计部分（建议设定）
        • 9.4.3.1 复选框
        • 9.4.3.2 初始参数（保持默认）
        • 9.4.3.3 迭代设置（保持默认）
        • 9.4.3.4 操作选项
        • 9.4.3.5 最终结果：显示
      • 9.4.4 CAC Section（保持默认）
      • 9.4.5 去马赛克和滤波器部分（不要求）
      • 9.4.6 色彩校正部分（不要求）
      • 9.4.7 Gamma校正部分（不要求）
    • 9.5 色彩处理控制（不要求）
    • 9.6 处理后图像显示
    • 9.7 测试图像
  • 5.17.9.11. 10 默认校准参数文件生成XML
    • 10.1 Defect Pixel色彩校正（保持默认）
    • 10.2 自动曝光校准（保持默认）
    • 10.3 HDR/Native HDR
    • 10.4 光响应线性（保持默认）
  • 5.17.9.12. 11 补充工具
    • 11.1 色彩校正合成器工具（不常用）
      • 11.1.1 色彩校正合成器工具介绍
      • 11.1.2 加载传感器光谱菜单
      • 11.1.3 合成选项
      • 11.1.4 查看色彩校正器菜单
    • 11.2 图像校正工具（不常用）
    • 11.3 XML生成器（常用）
      • 11.3.1 手动生成XML/json文件（推荐）
      • 11.3.2 （可选）自动生成XML文件（不建议）
• 5.17.10. VtunerClient工具指南
  • 5.17.10.1. 修订记录
  • 5.17.10.2. 1 X5 ISP introduction
    • 1.1 ISP Tuning工具简介
    • 1.2 操作系统兼容性
    • 1.3 Client-Server连接协议
    • 1.4 软件发行包
  • 5.17.10.3. 2 VtunerClient
    • 2.1 安装和启动
      • 2.1.1 安装 VTunerClient
      • 2.1.2 启动 VTunerClient 工作台
      • 2.1.3 创建ISP工程
      • 2.1.4 设置连接服务
    • 2.2 调试工作台
      • 2.2.1 ISP Tuner视图
        • 2.2.1.1 工具栏
        • 2.2.1.2 额外组件
          • 2.2.1.2.1 AWB Tool
        • 2.2.1.3 视图
      • 2.2.2 工程资源预览
      • 2.2.3 功能预览
      • 2.2.4 模块细节
        • 2.2.4.1 控制栏
        • 2.2.4.2 参数类型
          • 2.2.4.2.1 布尔参数
          • 2.2.4.2.2 整数/浮点参数
          • 2.2.4.2.3 选项参数
          • 2.2.4.2.4 数字矩阵参数
          • 2.2.4.2.5 ROI 矩阵参数
          • 2.2.4.2.6 颜色矩阵参数
          • 2.2.4.2.7 曲线参数
          • 2.2.4.2.8 文件参数
      • 2.2.5 控制台视图
    • 2.3 Tuning解决方案 – 弱参考
      • 2.3.1 导出和导入功能模块设置
        • 2.3.1.1 从ISP工程导出调试参数
        • 2.3.1.2 导入调试参数到 ISP 项目
      • 2.3.2 将原始图像注入Tuning Server
      • 2.3.3 Feature Module调试
      • 2.3.4 编辑寄存器
      • 2.3.5 Dump图像
      • 2.3.6 配置首选项
      • 2.3.7 批量Tuning
    • 2.4 自定义配置
      • 2.4.1 定义VTunerClient中显示的模块和参数
      • 2.4.2 自定义传感器信息
  • 5.17.10.4. 附录A
• 5.17.11. hbplayer 和 tuning_tool 工具使用指南
  • 5.17.11.1. hbplayer
    • hbplayer 安装及配置
    • hbplayer 主界面
  • 5.17.11.2. tuning_tool
    • 运行方法
      • 程序参数选项说明
      • feedback_param.json 配置说明
      • 使用步骤
    • 功能
      • dump raw
      • dump yuv
      • dump raw and yuv
      • 其他功能