跳到主要内容

ISP PQ 工具用户指南

Revision History

RevisionDateAuthorDescription
1.02024/07/09ZhirongliInitial drift
1.12024/10/08Zhirongli更新部分参数描述;新增AEM运动检测;更新CCM插件功能;更新AWB插件功能;版本匹配AsrlspToolV3.2.0.0

简介

概述

本文档主要介绍 SpacemiT 图像调试,包含调试工具(Tuning Tool)、定标插件(Calibration Plugins)、图像分析工具(VRF viewer),平台调试辅助等。

缩略语

NameDescription
ISPImage Signal Process
VRF / vrfRAW image with information at the end
BLCBlack Level Correction
LSCLens Shading Correction
AWBAuto White Balance
AECAuto Exposure Control
AFAuto Focus
OTPOne Time Programmable
AEMAuto Exposure Monitor
AFMAuto Focus Monitor
CCMColor Correction Matrix
CTColor Temperature
BPCBad Pixel Correction
CACColor Aberration Correction
LTMLocal Tone Mapping
PDCPhase Detection Compensation
PDFPhase Detection Correction
PDAFPhase Detection Auto Focus
SESpecial Effect
EISElectronic Image Stabilization
CDAFContrast Detection Auto Focus
FVFocus Value
SADSum of absolute difference
ROIRegion of Interest
NRNoise Reduction
EEEdge Enhancement
HDRHigh Dynamic Range
QnAccuracy, 2n is double

Tuning Tool 概述

Tuning Tool 框架

Figure - ISP Tool 框架

PC 端 tuning tool 安装

调试软件是免安装的压缩文件,解压即可使用,文件名 AsrIspToolVX.X.X.X.rar 调试工具可通过该链接获取:https://archive.spacemit.com/tools/isp-tunning/

解压后包含如下文件:

Figure - ISP Tool 文件

调试环境准备

软硬件需求

  • 硬件环境

    • 台式电脑或笔记本电脑
    • 1GHz 或更快的处理器
    • 1GB RAM(32 位) 2GB RAM(64 位)
    • 至少 10GB 可用硬盘空间
    • 1920 x 1080 屏幕分辨率或更高
    • USB 端口
    • 集成了 ASR ISP 的终端设备
  • 软件环境

    • Windows 7 64 位或以上版本的操作系统

设备连接

AsrIspTool 通过 USB 与终端设备连接,通过 ADB 与设备交互。

【注:连接之前设备需先启动 tuning server 线程,即启动 camera】

Tuning Tool 基本操作

Tuning Tool 主界面

双击 AsrIspTool.exe ,启动调试工具,主界面如 Figure 3.1-1 所示

Figure - ISP Tool 主界面

  • menu:菜单功能区

    • Open:打开参数文件
    • Save:保存参数文件
    • SaveAS:参数文件另存为
    • IP Address:reserved
    • ADB(SN):ADB 方式连接终端设备,支持输入 ADB serial
    • Connect:连接终端设备
    • Vied:单/水平叠加/垂直叠加 窗口显示
    • Format:十进制/十六进制显示切换
    • Display:矩阵编辑/行编辑/列编辑模式切换
    • Plugins:插件
    • Frequency:参数刷新速度调节
    • Capture:抓取 VRF 数据(vrf)
    • Register:ISP 寄存器读写工具
    • I2C:I2C 读写工具
    • Push: reserved
    • Transfer: reserved
    • VRF:看图工具
    • DNG:reserved
  • Module list & Filter list:模块列表

  • parameter list:参数列表

  • Log:日志区

Online 基本操作

连接终端设备

打开 tool 之后,在选择 ADB(SN),点击 Connect,连接成功会自动读取当前所有模块的参数,并以 500ms(功能菜单可修改 Frequency)为周期定时刷新只读参数。(多台终端与 PC 相连,可指定 serial)

如果想将可读写参数也定时刷新,将右上角 AutoUpdate 勾选即可(勾选之后参数不可设置)。

如果想单次读取所有参数,点击右上角 Read 按钮。

Figure - ISP Tool 连接界面

注意:ADB 连接方式只适用于使用 Android 系统的项目,我们主要使用 TCP 网络连接开发板进行 tunning。

参数类型说明

Figure - 参数说明

  • 可调参数

    • 可勾选参数,如 m_bAutoCalculateAEMWindow
    • 可编辑参数,如 m_nPreEndingPercentage
    • 可编辑数组参数,如 m_pSubROIPermil,若为二维数组,可切换矩阵/行/列编辑模式
  • 只读(灰色)

    • 只读,如 m_nAdjacentLumaSAD
  • 特别说明

    • 在插件或参数列表中修改参数,会标红显示修改的内容,鼠标覆盖时会显示原值。

实时修改参数

  1. 在模块列表区展开想要调试的模块列表
  2. 在模块列表区点击想要修改的模块
  3. 在参数列表区通过滑动条或者直接修改参数值,参数即时生效。

抓取 VRF 图

  1. 在菜单功能区点击 Capture 按钮
  2. 选择 RAW,设置保存路径
  3. 点击 Start Capturing 可生成后缀为 vrf 的原始图像

Register 读写

Figure - Register 读写

  • 在菜单功能区点击 Register 按钮

  • 设置 Address(寄存器地址)

  • Value(8bit)(寄存器值)

    • Read 读寄存器
    • Write 写寄存器
  • Value(32bit)(寄存器值)

    • Read 读寄存器
    • Write 写寄存器

I2C 读写

Figure - I2C 读写

  • 在菜单功能区点击 I2C 按钮

  • 设置 Device ID (I2C 设备号)

  • 设置 Device Address (从设备地址)

  • 设置 Address Bytes(寄存器地址位宽)

  • 设置 Register Address(寄存器地址)

  • 设置 Value Bytes(寄存器值位宽)

  • Value(寄存器值)

    • Read 读寄存器 / Batch Read 文件导入批量读寄存器
    • Write 写寄存器 / Batch Write 文件导入批量写寄存器批量读写寄存器文件格式如下,{Address, Value }, 批量读写寄存器点击 Batch Read / Batch Write 导入 reg_batch.txt。读取结果会在红色框中显示对应 log,同时会生成同名_read.txt 用于后续查看。

批量读写寄存器文件格式示例

Figure - I2C 批量读

保存参数

  1. 在菜单功能区点击 Save 按钮
  2. 选择路径并设置文件名
  3. 点击保存生成参数文件

打开本地参数文件

在菜单功能区点击 Open 按钮或者直接拖曳对应参数文件到工具对应模块中,该操作将把参数直接写入硬件;

Offline 基本操作

打开本地参数文件

  1. 在菜单功能区点击 Open 按钮或者直接拖曳参数文件到工具中;

修改参数

  1. 在模块列表区展开想要调试的模块列表;
  2. 在模块列表区点击想要修改的模块;
  3. 在参数列表区通过滑动条或者直接修改参数值;
  4. 如果是一维向量,在参数编辑界面点击波形按钮可进入曲线编辑模式;

定标插件

  1. 在菜单功能区点击 Plugins 下拉菜单选择插件;

保存参数

  1. 在菜单功能区点击 Save 按钮,输入文件名,参数将保存至本地文件;

ISP 插件

本节介绍 BLC、LSC、AWB、CCM、Curve、Noise、PDC、PDAF 定标调试,以及调试辅助工具 General Information、Raw preprocessor。

标定插件支持 online(连接设备)与 offline(导入参数文件),只有打开对应 Filter 参数时,插件才能打开。

BLC 定标与调试

BLC 定标 VRF 图要求

在全黑环境或将镜头完全遮挡采集 VRF 数据。

BLC 定标步骤

Figure - BLC 定标界面

  1. 在 BLC 插件中点击 Load 导入 VRF 图;
  2. 选择 Pipe ID(非单 pipeline 可选);
  3. 选择 Channel ID;
  4. 点击 Calibrate,校正结果显示在 Calibrated Result 界面,若结果不理想亦可手动修改 Result;
  5. 点击 Update,参数将更新到参数列表,若结果不理想,可点击 Cancel 重新校正;

BLC 定标说明

  • Calibrated Result panel 显示 4 个通道,10bits 与 8bits 的值,参数保存到文件中会映射到 12bits。
  • Channel ID:表示对应 2 ᵅ[倍 gain 下的 BLC 参数,BLC 可随 Gain 调整,从 1x 倍 gain 到 2048 倍 gain,共 12 个等级(见 Gain-BlackValue 示意图);最后一档 manual 在 manual mode 使能时生效,此时 BLC 不随 gain 调整。

Gain – BlackValue 示意图

BLC 调试说明

BLC 参数位于 CDigitalGainFirmwareFilter

  • 若 BLC 不随增益变化,将 m_bManualMode 置为 1,此时 BLC 值为 m_pGlobalBlackValueManual
  • 若 BLC 随增益变化,将 m_bManualMode 置为 0,此时 BLC 值为 m_pGlobalBlackValue

LSC 定标与调试

LSC 定标 VRF 图要求

在灯箱环境(D65、 CWF、 A 光)或存在 shading 的环境中使用 diffuse 挡住镜头,拍摄若干进光均匀的图片。

LSC 定标步骤

Figure - LSC 定标界面

  1. 在 LSC 插件中点击 Load 导入 VRF 图;
  2. 选择 Pipe ID(非单 pipeline 可选);
  3. 选择 Channel ID;
  4. 调整补偿的比例 Current Percentage,建议先设为 100%,后期可修改 strength 控制补偿强度;
  5. 点击 Calibrate,校正仿真结果显示在 Calibrated Image;
  6. 点击 Update,参数将更新到参数列表,若结果不理想,可点击 Cancel 重新校正;

LSC 定标说明

  • Channel ID: 0 为低色温补偿表;1 为中色温补偿表;2 为高色温补偿表;manual 在 manual mode 使能时生效,此时 LSC 不随色温调整。

LSC 调试说明

LSC 可随 CT 或 CorrelatedCT 调整(见 CT-LSCProfile 示意图)

CT 定义: 256*AWB_RGain/AWB_BGain(可通过 AWB plugin 中的 CT 信息/4 获得);

CorrelatedCT 定义:相关色温,光源发出的光与某一色温的黑体辐射光相似的程度

CT – LSCProfile 示意图

LSC 参数位于 CLSCFirmwareFilter

  • LSC 需随色温变化,设置合适的 m_pCTIndex,以设置不同色温下的 Shading 表。

【注:LSC 插值依据可选择 AWBFilter 计算结果 CT(在 AWB 插件中读取 CT)或 CCTCalculatorFilter 计算结果 CCT(在 WbFirmwareFilter 中读取 m_nCorrelationCT),推荐使用 m_nCorrelationCT】

CCM 与 CCT 定标与调试

CCM 定标 VRF 图要求

在灯箱环境中使用拍摄 24 色卡,画面中色卡尽量对正,色卡居中,占画面约 1/9。

D65 、CWF 、 A 光是必要的光源。

CCM 定标步骤

Figure - CCM 定标界面

  1. 在 CCM 插件中点击 Load 导入 VRF 图,VRF 使用 Raw preprocessor 插件补偿 LSC 和 PDF(如存在 PD 像素);
  2. 在图中框选完整的色卡,保证 24 个 ROI 都落在色块之内,若拍摄图片不正或畸变严重,可点击 start,勾选期望单独调整的 ROI,然后手动拖动 ROI;
  3. 设定期望校正的饱和度;
  4. 点击 Calibrate,校正仿真结果显示在 Calibrated Result;
  5. 选择 Pipe ID(非单 pipeline 可选);
  6. 选择 Channel ID;
  7. 点击 Update,参数将更新到参数列表,若结果不理想,可在 Saturation Table 中针对修改某一个 block 的饱和度,然后重新 calibrate;

CCT 定标步骤

Figure - CCM 定标界面

  1. 定标步骤与 CCM 定标可同时进行, CCT 只需要 A 与 D65;
  2. CCM Calibrate A 光之后,选择 profile 2850K,点击 UpdateCTMatrix;
  3. CCM Calibrate D65 光之后,选择 profile 6500K,点击 UpdateCTMatrix;
  4. 结果将自动更新到 CCTCaluatorFilter 中 m_pCTMatrix_low / high 中;

CCM 定标说明

  • Use Internal Curve – Calibration: 无需勾选
  • Use Internal Curve – Render: 无需勾选
  • Use AGTM: 勾选
  • Target:保持 D50
  • View Environment:保持 D50
  • Calibrated Result: 显示校正之后的仿真结果
  • CCM Result: 列出了校正之后的色彩矩阵,此处亦可手动修改,点击 set 设到硬件中;
  • Channel ID:0 为低色温 CCM 参数;1 为中色温 CCM 参数;2 为高色温 CCM 参数;manual 在 manual mode 使能时生效,此时 CCM 不随色温调整。
  • Make DNG Profile: reserved
  • UpdateCTMatrix:更新 CCT matrix
  • SaveImage:保存 render 出的图片

CCM 调试说明

CCM 可随色温调整(见图 CCM-色温控制曲线)

CT – CCM index 示意图

CCM 参数位于 CColorMatrixFirmwareFilter

  • CCM 需随色温变化,设置合适的 m_pCTIndex,以设置不同色温下的色彩矩阵,推荐使用 CorrelatedCT。

【注:CCM 插值依据可选择 AWBFilter 计算结果 CT(在 AWB 插件中读取 CT)或 CCTCalculatorFilter 计算结果 CCT(在 WbF irmwareFilter 中读取 m_nCorrelationCT)】

AWB 定标与调试

AWB 白点定标 VRF 图要求

AWB 定标无需额外拍图,完成 CCT 定标即可进行。

AWB 白点定标步骤

Figure - AWB 定标界面

  1. 打开 AWB 插件。
  2. 点击 Optimize,定标参数将自动更新到参数界面;

AWB 亮度定标

在 AE 调试完成之后,需对模组亮度进行定标, 从而得到 AWB 需要的 Lux,定标步骤如下:

  1. 相机置于灯箱,拍摄灯箱壁,光源选择 D65;
  2. 使用色温照度计测量灯箱照度,填入 AECFilter 中 m_nCalibSceneLux;
  3. 在 AECFilter 中读取 m_nExpIndexLong,填入 AECFilter 中 m_nCalibExposureIndex;
  4. 在 AECFilter 中读取 m_nLumQ16,填入 AECFilter 中 m_nCalibSceneLum;
参数名说明建议调试特殊性
m_nCalibExposureIndex亮度定标的曝光索引
m_nCalibSceneLum亮度定标的场景亮度
m_nCalibSceneLux定标场景对应的实际照度
m_nSceneLuxAWB debug参数,当前AE计算得到的场景照度-只读

AWB Debug

Block debug 信息

连接设备,点击 AWB 插件,每个 block 的落点将以蓝色点显示在坐标轴上,AWB 统计图像显示为缩略图。

统计图上可框选区域(默认展示所有区域的落点),框选之后只会显示框中 block 的落点。

Figure - AWB 插件界面

ROI 中的白点

点击 Show ROI, 可以看到不同 ROI 中包含的 block 情况,白色为参与白平衡计算的 block,即落入 ROI 区域的 block。

下图可见具体 32X24 个 block 所属 ROI。

Figure - ROI 信息界面

Block 的权重

勾选 auto update 会定时更新 lux 及统计图,并实时计算 block 的权重。

拖动 Weight Percentage,可以调整 debug 图上实际场景与参与白平衡计算的 block 的比例。0% 显示实际场景,100% 显示参与白平衡计算的 block 的权重(权重参考热力图)。

若设为 100%,画面显示为全黑,表示该 lux 下所有 block 权重为 0。

Figure – AWB 插件界面

设置 Weight Percentage 为 100%,以热力图形式显示 block 的权重,可以将鼠标拖动到期望了解的 block,热力图右侧会显示对应 block 的权重(AWB Frameinfo 也可以看到 debug 信息),上图鼠标选择的是 block[12][2],权重为 16

白平衡 gain 的落点

RGB gain panel 模块,勾选 enabled,填入 Q12 精度的 RGB gain (debug 信息 CurrentResult),对应白平衡 gain 在色温坐标系中以蓝色方块呈现,色温坐标系通过鼠标从左上到右下框选放大,从右下到左上框选缩小。

当前白平衡 gain 在色温坐标系中以红色方块呈现。

Figure – 白平衡落点

AWB 调试说明

  • 定标 Panel

    • Calibrate Panel
      • Visible:勾选将在坐标中显示该 ROI
      • Enable:勾选将使能该 ROI
    • Calibrate Files Panel
      • Percentage:选取 VRF 图的比例。20%,表示选择中心 20% 的区域用于定标,图像中心的区域受到 shading 的影响较小。
      • Optimize:自动定标
      • Load config: (reserved)
      • Save config: (reserved)
      • Load:导入 VRF
      • Calibrate:reserved
      • Update:更新参数到参数列表
      • Cancel:取消参数更新
      • ShowROI:显示各个 ROI 的百点情况
  • 调试 Panel

    • Control Panel
      • Pipe ID:当前的 pipeline ID(非单 pipe 可选)
      • Auto Update:online 状态自动更新当前亮度与统计窗口(勾选时,在插件中将不能修改参数)
      • Manual Lux:固定当前亮度
      • Weight Percentage:debug 参数,调整显示白平衡统计块与块的权重。0% 显示统计块,100% 显示块权重热力图。
      • RGB Gain:debug apply 的 gain,对应色温坐标系中红色的点。
      • Luminance Boundary:参与 AWB 统计的像素的亮度区间(8 bit)
      • Valid Number:白平衡计算所需最少有效 block,[0,768]
      • Correct Limit Panel:block 限制区间,超出 Limit 且处于 ROI 的 block 将会在 XY 上方向映射。
    • Green Shift Panel
      • Shift Max Weight:shift 权重,与 exposure shift 相乘得到最终的 shift 权重,最大 32,完全偏向 outdoor gain
      • Green Number Threshold:落在 G 区的 block 的数目,在此区间则进入 green shift
      • Outdoor RGB Gain:green shift 目标 gain
      • Shift Weight:依据 exposure 调整 weight
    • Luminance Panel
      • Lux:亮度索引
      • Weight:对应 ROI 在当前亮度下的权重
      • Min / Max:luma 区间(8 bit)
  • Debug Panel

    • RGB Gain Panel
      • enabled:用于展示白平衡 gain 在色温坐标系的位置
      • RGB:白平衡 gain
    • Gain Panel:debug 信息,鼠标在色温坐标系上滑动,可显示对应位置的 debug 信息。
      • X Y:色温坐标系上点对应 XY 坐标
      • CT:色温坐标系上点对应 CT 值, 可用于提供 LSC、CCM 插值依据。
      • RGB:色温坐标系上点对应白平衡 gain
      • CCT 、Tint:色温坐标系上点对应 CCT 与 Tint, 可用于提供 LSC、CCM 插值依据。
      • CCT curve:色温坐标系上显示 CCT curve。
      • Vaild only:色温坐标系上只展示有效统计块。
      • Applied Gain:当前场景白平衡 gain 落点,对应色温坐标系中红色的点。
      • Block 、Weight:鼠标在统计图上滑动,可显示对应 block 的位置及权重。

Curve 调试

Curve 调试步骤

Figure - Curve 调试界面

  1. 打开 Curve 插件;
  2. 选择 Pipe ID(非单 pipeline 可选);
  3. 选择 Channel ID;
  4. 鼠标滑至 Curve 上想要调节的点,左键拖动到期望位置;
  5. 点击 Update,参数将更新到参数列表,若结果不理想,可点击 Cancel 重新校正;

Curve 调试说明

  • Channel ID:
    • BacklightCurveManual:用于控制背景亮度,建议保持曲线不变,调整 strength 即可;
    • ContrastCurveManual:用于控制对比度,建议保持曲线不变,调整 strength 即可;
    • GTMCurve0:gain 为 m_pGainIndex[0] (Q4 精度)时的曲线
    • GTMCurve1:gain 为 m_pGainIndex[1] (Q4 精度)时的曲线
    • GTMCurve2:gain 为 m_pGainIndex[2] (Q4 精度)时的曲线

【注:当 m_nCurveSelectOption 设为 0 时,curve 依据当前 gain 做插值(见 Curve-Gain 控制曲线示意图)】

Gain– Curve index 示意图

Curve 参数位于 CCurveFirmwareFilter

  • Curve 可随 gain 变化,设置合适的 m_pGainIndex,以设置不同 gain 下的 curve。

Noise 定标与调试

Noise 定标 RAW 图要求

在实验室环境中使用拍摄 24 色卡,画面中色卡尽量对正,色卡居中,占比约 1/9。

控制灯光亮度,依次拍摄 1、2、4、8、16、32、64、128、256、512、1024、2048 倍 Gain 下的色卡。

Noise 定标步骤

Figure 5.6.2 Noise 定标界面

  1. 在 Noise 插件中点击 Load 导入 RAW 图,VRF 使用 Raw preprocessor 插件补偿 LSC 和 PDF(如存在 PD 像素);
  2. 在图中框选色卡最下方的 6 个块,保证 6 个 ROI 都落在色块之内,若拍摄图片不正或畸变严重,可点击 sta rt,勾选期望单独调整的 ROI,然后手动拖动 ROI;
  3. 设定期望 Denois Strength;
  4. 点击 Calibrate,标定噪声水平显示在 Noise Result;
  5. 选择 Pipe ID;
  6. 选择 Channel ID;
  7. 点击 Update,参数将更新到参数列表,若结果不理想,可点击 Cancel 重新校正;

Noise 定标说明

  • Noise Result 显示标定的噪声水平;
  • Channel ID: 0 为 1 倍 gain 下的去噪参数;1 为 2 倍 gain 下的去噪参数;以此类推,11 为 2048 倍 gain 下的去噪参数;manual 为 manual mode 下的去噪参数。

PDAF 定标

PDAF 定标 VRF 图要求

在实验室环境中拍摄棋盘格,拍摄物距 2 米,棋盘格和 sensor 平行。

控制灯光亮度,使得增益尽量接近 1 倍。

拍摄马达从有效位置最小值到有效位置最大值的图像(将整个扫描区域均分成 30 段, 31 个位置),共 31 张(vrf 文件名命名规范为 position.vrf ,PD raw files 文件名 position_L.raw,position_R.raw)

PDAF 定标步骤

Figure - PDAF 定标界面

  1. 在 PDC 插件中点击 Load 选择 VRF 文件夹(若导入的是已抽出 PD 的 raw files,还需填写 raw 的宽高);
  2. 点击 Calibrate,将显示图像分割为 5x5 的块所对应的块的 position – shift 图;
  3. 选择 Pipe ID(非单 pipeline 可选);
  4. 点击 Update,CAFFilter 中 m_pPDShiftPositionLUT 参数将更新,
  5. 若结果不理想,可点击 Cancel 重新校正;

PDC 定标

PDC 用于将 PD 像素或 shadow 像素亮度补偿到正常亮度供 PDAF 对焦算法使用。

已知 PD 点,shadow 分布情况(m_pPixelMask 和 m_pPixelTypeMask)下,通过含 PD 点分布的图像,对 PDC 参数 m_pRatioBMap 进行标定。

PDC 定标 VRF 图要求

在灯箱环境 D65 中,使用毛玻璃拍摄灯箱壁。

PDC 定标步骤

Figure - PDC 定标界面

  1. 在 PDC 插件中点击 Analyze,pdc plugin 判断 setting 中 m_pPixelMask 和 m_pPixelTypeMask 设置是否合理,如果不合理需要调整这两个参数。
  2. Analyze 分析 setting,合理后,Load 按钮有效化。QuadBayer PD 可选择补偿方式(0-1 通道互补或 2-3 通道互补,四通道 PD 点数目相同时,还可选择四通道互补)。
  3. Load 图像成功后,右边会显示对应通道抽取的 PD 点组成的小图像。按下 Calibrate 按钮,会计算根据图像计算得到的 m_pRatioBMap,并会将用新的 m_pRatioBMap 补偿过的 P D 点组成的小图像显示在右图中。
  4. Update 按钮会更新 PDC 参数中 m_pRatioBMap,若结果不理想,可点击 Cancel 重新校正。
  5. 选择 Pipe ID(非单 pipeline 可选)。
  6. 点击 Update,参数将更新到参数列表,若结果不理想,可点击 Cancel 重新校正。

PDC 定标说明

m_pPixelMask,m_pPixelTypeMask 说明

  1. 两个参数标定图像 PD,shadow 分布,分布以 32x32 周期分布。如果 m_pPixelMask=1,则当前点为 PD 点,m_pPixelTypeMask 表示像素遮蔽的四种方向;如果 m_pPixelMask=0,m_pPixelTypeMask>0,则当前点为 s hadow 点。
  2. 两个参数一般由 sensor 厂商提供,如果没有则拍摄 RAW 图手工标定。

Raw preprocessor 插件

Raw preprocessor 插件说明

Raw preprocessor 插件用于 raw 预处理,支持 PD 点矫正,LSC 补偿,Unpack VRF(ASR RAW packed format)功能。

Raw preprocessor 插件使用

Figure - Raw preprocessor 界面

  1. 在 Raw preprocessor 插件中设置 input 和 output VRF 文件;
  2. 选择对应的 pipe 以及 LSC channel;
  3. 选择期望的预处理功能,PDF,LSC,Unpack;
  4. 点击 Preprocess
  5. Batch preprocess 支持文件夹导入,批处理 VRF 文件

General Information 插件

General Information 插件用于连接设备实时显示一些 debug 信息

General Information 显示

默认配置了如下信息供调试工程师参考

Figure - General Information 信息

General Information 拓展

点击 setting,出现如下信息编辑页,可以自由编辑想要关注的信息。一行为一个显示条目,格式说明详见 Expression Manual

Figure - General Information 拓展

ISP Tuning

CTopFirmwareFilter 调试说明

CTopFirmwareFilter 用于配置 ISP Top 信息。

TOP 参数

参数名说明建议调试特殊性
m_nBayerPatternBayer模式:0: RGGB 1: GRBG 2: GBRG 3: BGGR 4: monochrome依据硬件设置
m_bAELinkZoomAE窗口关联zoom用户设置
m_bAFLinkZoomAF关联zoom用户设置
m_bAWBLinkZoomAWB关联zoom用户设置
m_nPreviewZoomRatio预览zoom系数,Q8用户设置
m_bPreviewLowPowerMode预览低功耗模式用户设置
m_nAEProcessPositionAE处理时机0: eof 1: sof用户设置
m_nAEProcessFrameNumAE处理频率,支持:eof每帧处理 / eof 每两帧处理 / sof每帧处理 / sof 每三帧处理用户设置
m_bHighQualityPreviewZoomEnableReserved

CAEMFirmwareFilter 参数说明

CAEMFirmwareFilter 模块用于配置自动曝光统计模块。

AEM 使能及参数

参数名说明建议调试特殊性
m_bEnableAEM使能:0:关闭自动曝光统计模块 1:使能自动曝光统计模块
m_nAEStatModeAE统计模块模式:0:统计信息不经过白平衡 1:统计信息经过白平衡
m_bZSLHDRCapture零延迟HDR抓拍使能0:不启动 1:启动零延迟HDR抓拍功能用户设置
m_nInitialExpTime初始化曝光时间
m_nInitialAnaGain初始化模拟增益
m_nInitialSnsTotalGain初始化sensor总增益
m_nInitialTotalGain初始化总增益
m_nStableToleranceAE稳定容忍度百分比:若当前曝光量与前一次曝光量的差值小于前一次曝光量的m_nStableTolerance%,则给出AE StableFlag信号,供其他模块如LTM参考用户设置
m_nStableToleranceExternalAE稳定容忍度百分比,共外部系统使用用户设置
m_bAutoCalculateAEMWindowAE统计窗口计算方式:0:由hardware配置 1:由firmware控制
m_nPreEndingPercentage不参与AE统计模块的行数相对于图像高的百分比
m_bDRCGainSyncOptionDRCgain同步:0:每帧同步 1:AE稳定后同步
m_pSceneChangeSADThr判断场景变化的SAD门限用户设置
m_pSubROIPermil6个子统计模块的起始坐标及结束坐标相对于图像宽高的千分比可根据人脸测光或对焦测光联动,由application修改用户设置
m_nSubROIScaleFactor副窗口缩放百分比系数用户设置
m_nFaceLumaOption人脸亮度统计方式:0:硬件统计(pixel) 1:软件统计(block)
m_bMotionDetectEnable运动检测开关:0:关闭运动检测 1:使能运动检测用户设置
m_bMotionDetectExt运动检测方式:0: 使用内部 AEM 统计 1:使用外部 gyro sensor用户设置
m_nMotionStrengthExt外部运动强度控制,运动检测方式为外部 gyro 时有效用户设置
m_nSADIntervalFrame计算 SAD 的间隔帧数,运动检测方式内部 AEM 统计时有效
m_nMotionThreshold判断运动的 SAD 门限,运动检测方式内部 AEM 统计时有效
m_nMotionDetectFrame连续 m_nMotionDetectFrame 帧检测到 SAD 超过门限,则认为是运动场景
m_nFaceDetFrameID侦测到人脸的帧号-只读
m_nAdjacentLumaSAD当前SAD-只读
m_pMainRoiCoordinate主窗口坐标-只读
m_pSubRoiCoordinate副窗口坐标-只读

CDigitalGainFirmwareFilter 参数说明

CDigitalGainFirmwareFilter 模块用于配置数字增益和黑电平。

DigitalGain 使能及参数

参数名说明建议调试特殊性
m_bEnabledigital gain使能:0:关闭数字gain 1: 使能数字gain用户设置
m_nISPGlobalOffsetValue12bit0:在stretch中扣除黑电平1:在digital gain中完全扣除黑电平2-511:完全扣除黑电平后,12bit添加的offset(此offset会在stretch扣除)用户设置
m_bManualMode手动模式使能 0: 自动模式1: 打开手动模式,此时黑电平参数不随gain变化,使用manual参数,用于debug
m_pGlobalBlackValueManual手动模式参数,作用和自动一致
m_pGlobalBlackValueManualCapture同上,拍照起效
m_pGlobalBlackValueR/ GR/ GB/ B四个通道的黑电平(见Gain-BlackValue示意图)定标结果参数可随gain变化
m_pGlobalBlackValueCapture同上,拍照起效定标结果参数可随gain变化
m_pWBGoldenSignature白平衡golden模组特征-只读
m_pWBCurrentSignature白平衡当前模组特征-只读

Gain – BlackValue 示意图

CWBGainFirmwareFilter 参数说明

CWBGainFirmwareFilter 模块用于自动白平衡增益。

WBGain 使能

参数名说明建议调试特殊性
m_bEnableWB gain使能:0:关闭白平衡gain 1: 使能白平衡gain

CStretchFirmwareFilter 参数说明

CStretchFirmwareFilter 模块用于弥补扣除黑电平之后像素不饱和。

Stretch 使能

参数名说明建议调试特殊性
m_bEnablestretch使能:常开,用于弥补扣除黑电平,并补偿像素不饱和

CColorMatrixFirmwareFilter 参数说明

CColorMatrixFirmwareFilter(CCM)模块用于色彩校正。

CCM 使能

参数名说明建议调试特殊性
m_bEnableCMC使能:0:关闭色彩校正矩阵 1:使能色彩校正矩阵

CCM 参数及调试

参数名说明建议调试特殊性
m_bUseCorrelatedCT插值依据选项:0:使用AWB的CT 1:使用WbFirmwareFilter中m_nCorrelationCT(CCT matrix需要标定)用户设置
m_pColorTemperatureIndex色温分段控制点。(示例见图cmc-色温控制曲线)色温位于[0,Index[0]]区间,认定为低色温区间,使用CMC0的色彩校正矩阵;色温位于[Index[0],Index[1]]区间,使用CMC0与CMC1插值的色彩校正矩阵;色温位于[Index[1],Index[2]]区间,认定为中色温区间,使用CMC1的色彩校正矩阵;色温位于[Index[2],Index[3]]区间,使用CMC1与CMC2插值的色彩校正矩阵;色温位于[Index[3],8192]区间,认定为高色温区间,使用CMC2的色彩校正矩阵;
m_pCMC0低色温色彩校正矩阵,由CCM插件定标得到。R'G'B' to RGB ,Q12精度。定标结果参数可依据色温调用
m_pCMC1中色温色彩校正矩阵,由CCM插件定标得到。R'G'B' to RGB ,Q12精度。定标结果参数可依据色温调用
m_pCMC2高色温色彩校正矩阵,由CCM插件定标得到。R'G'B' to RGB ,Q12精度。定标结果参数可依据色温调用

图 cmc-色温控制曲线

CCM 彩边抑制功能及参数

参数名说明建议调试特殊性
m_bColorFringleRemoveEnable彩边抑制使能:0:关闭 1: 使能用户设置
m_nColorFringRemovalStrength彩边抑制强度:值越大,彩边抑制效果越强

备注:Final CFR_Ratio=HueRatio*EdgeRatio>>HighFreqTransShiftNum

  • Hue 控制参数
参数名说明建议调试特殊性
m_nHueTransShiftNumHue过渡带偏移系数:(示例见图HueTrans-HueRatio控制曲线)Hue落入[(ColorFringeHueRange[0]-(1<<ShiftNum),ColorFringeHueRange[0]]区间做平滑处理;Hue落入[ColorFringeHueRange[1],(ColorFringeHueRange[1]+(1<<ShiftNum)]区间做平滑处理;
m_pColorFringeHueRange彩边抑制的Hue区间(示例见图HueTrans-HueRatio控制曲线)HueRange[0] 需小于 HueRange[1]

ColorFringeHueRange[0],[1]用于选定彩边抑制的 Hue 区间;

HueTransShiftNum 用于设定平滑过渡带:

图 HueTrans-HueRatio 曲线

  • Freq 控制参数
参数名说明建议调试特殊性
m_nHighFreqThreshold彩边抑制频率下限(示例见HighFreqTrans-EdgeRatio曲线)值越大,更少边缘进入彩边抑制区域
m_nHighFreqTransShiftNum高频过渡带偏移系数(示例见HighFreqTrans-EdgeRatio曲线)频率落入[HighFreqThreshold, HighFreqThreshold +(1<<HighFreqTransShiftNum)]区间做平滑处理

图 HighFreqTrans-EdgeRatio 曲线

CCM Manual 参数

参数名说明建议调试特殊性
m_bManualMode手动模式使能 0: 自动模式1: 打开手动模式,此时色彩校正矩阵参数不随色温变化,使用manual参数,用于debug-Debug参数
m_pCMCManual手动模式参数,作用和自动一致-Debug参数

CCM 其他参数

参数名说明建议调试特殊性
m_bDisgardHFEnable丢弃高频信息使能:0:添加高频信息 1:丢弃高频信息用户设置
m_pCMCSaturationList饱和度控制可随Gain变化

CBPCFirmwareFilter 调试说明

CBPCFirmwareFilter(BPC)模块用于去坏点。

BPC 使能

参数名说明建议调试特殊性
m_bEnableBPC使能0: 关闭坏点校正 1: 打开坏点校正用户设置

BPC 动态控制参数

BPC 强度可随增益与亮度动态调节。

参数名说明建议调试特殊性
m_pBpcGainIndex增益索引,建议保持缺省值Gain控制节点
m_pSegG亮度索引,相邻两档间跨度须保证为2的整数幂,建议保持缺省值Lum控制节点
  • 增益控制参数为 m_pBpcGainIndex ,0-11 共十二组,16 为 1 倍增益,增益处于两个节点之间时,参数为两个节点参数插值的结果。

  • 亮度控制参数为 m_pSegG,0-8 共九组,其中第 8 组固定为 255 不可改,对应 VRF 数据像素值(映射到 8 比特),亮度处于两个节点之间时,参数为两个节点参数插值的结果,相邻两档间跨度须保证为 2 的整数幂,建议保持缺省值。

  • 强度控制参数,可随增益和亮度的变化动态调节。
参数名说明建议调试特殊性
m_pCrossChnStrength跨通道强度,值越大,参考更多其他通道信息,也更容易受其他通道的坏像素干扰可随Gain变化
m_pSlopeGG通道控制曲线参数,值越大,容忍度越大,去坏点能力越弱可随Gain和Lum变化
m_pInterceptGG通道控制曲线参数,值越大,容忍度越大,去坏点能力越弱可随Gain和Lum变化
m_pSlopeRBRB通道控制曲线参数,值越大,容忍度越大,去坏点能力越弱可随Gain和Lum变化
m_pInterceptRBRB通道控制曲线参数,值越大,容忍度越大,去坏点能力越弱可随Gain和Lum变化

以 m_pSlopeG 为例:

Column 表示 Gain 的档位,与 m_pBpcGainIndex 一一对应。

Row 表示 Lum 档位,与 m_pSegG 一一对应。

  • 参数随 Lum 变化插值说明

【注:上述随 Lum 变化的 Value 包含 Slope, Intercept】

【注:最终容忍度由 Slope, Intercept, Ratio 共同决定,容忍度 = (Lum*Current_Slope+Current_Intercept)*Ratio. 容忍度越大,去坏点越弱】

说明:Current_Slope 与 Current_Intercept 均根据 Lum 和 gain 变化插值得出说明:Ratio 分为 Dead/SpikeRatio 与 RB/G,共 4 种情况

BPC 功能模块及参数

参数名说明建议调试特殊性
m_nMinThrEn暗点检测通道选择Bit 0:参考跨通道信息使能;Bit 1:参考GrGb通道信息使能;Bit 2:参考相同通道信息使能。
m_nMaxThrEn亮点检测通道选择Bit 0:参考跨通道信息使能;Bit 1:参考GrGb通道信息使能;Bit 2:参考相同通道信息使能。
m_nNearThr使用跨通道的亮度下限值,只有亮度大于此阈值时,才会使用跨通道信息。
m_bDeadEnable暗点矫正使能用户设置
m_nDeadRatioGG通道暗点系数,值越大,G通道暗点容忍度越大,去坏点能力越弱
m_nDeadRatioRBRB通道暗点系数,值越大,RB通道暗点容忍度越大,去坏点能力越弱
m_bSpikeEnable亮点矫正使能用户设置
m_nSpikeRatioGG通道亮点系数,值越大,G通道亮点容忍度越大,去坏点能力越弱
m_nSpikeRatioRBRB通道亮点系数,值越大,RB通道亮点容忍度越大,去坏点能力越弱
m_bSameChnNum相同通道预矫正使能1:打开相同通道预矫正,开启后可排除相同通道坏点干扰用户设置
m_nDeltaThr相同通道预矫正阈值,建议保持缺省值
m_nRingGRatio相同通道预矫正阈值,建议保持缺省值
m_nRingMeanRatio相同通道预矫正阈值,建议保持缺省值
m_bCornerDetEn拐角检测使能使能可保护拐角用户设置
m_pSlopeCorner拐角控制曲线参数,值越大,保护的拐角越少,与容忍度无关可随Gain和Lum变化
m_pInterceptCorner拐角控制曲线参数,值越大,保护的拐角越少,与容忍度无关可随Gain和Lum变化
m_bEdgeDetEn边缘检测使能使能可保护边缘用户设置
m_nEdgeTimes边缘判定门限,值越小,边缘保护的越多
m_bGrGbNumGrGb通道预矫正使能1:打开GrGb通道预矫正,开启后可排除GrGb通道坏点干扰用户设置
m_bAroundDetEn亮块检测使能使能可保护亮度突变的像素块用户设置
m_bBlockDetEn2x2 坏块检测使能使能可排除2x2坏块干扰用户设置

BPC Manual 参数

参数名说明建议调试特殊性
m_bManualMode手动模式使能1: 打开手动模式,此时bpc参数不随gain变化,使用manual参数,用于debug-Debug参数
m_nCrossChnStrengthManual手动模式参数, 具体功能和自动功能一致-Debug参数
m_pSlopeGManual手动模式参数, 具体功能和自动功能一致-Debug参数
m_pInterceptGManual手动模式参数, 具体功能和自动功能一致-Debug参数
m_pSlopeRBManual手动模式参数, 具体功能和自动功能一致-Debug参数
m_pInterceptRBManual手动模式参数, 具体功能和自动功能一致-Debug参数
m_pSlopeCornerManual手动模式参数, 具体功能和自动功能一致-Debug参数
m_pInterceptCornerManual手动模式参数, 具体功能和自动功能一致-Debug参数

CLSCFirmwareFilter 参数说明

CLSCFirmwareFilter 模块用于镜头阴影矫正。

LSC 使能

参数名说明建议调试特殊性
m_bEnableLSC使能0: 关闭镜头阴影校正 1: 打开镜头阴影校正用户设置
m_bUseOTPLSC OTP使能用户设置

LSC 参数

参数名说明建议调试特殊性
m_bAutoScaleAutoScale使能:0: 关闭自动计算缩放参数功能 1: 打开自动计算缩放参数功能
m_bEnhanceEnableEnhance使能:当前模组期望补偿倍数超过4倍时需要打开0: 关闭shading增强功能 1: 打开shading增强功能用户设置
m_nProfileSelectOptionshading补偿表选择:0:依据色温自动选择 1:使用LSC Profile[0] 2:使用LSC Profile[2] 3:使用LSC Profile[2]
m_nFOVCropRatioH水平方向裁剪比例binning尺寸决定
m_nFOVCropRatioV垂直方向裁剪比例binning尺寸决定
m_pLSCStrengthshading补偿强度:(示例见Gain-strength示意图)64表示1倍; 32表示1/2倍; 16表示1/4倍; 其他值以此类推可依据gain调整
m_bUseCorrelatedCT插值依据选项:0:使用AWB的CT 1:使用WbFirmwareFilter中m_nCorrelationCT(CCT matrix需要标定)用户设置
m_pCTIndex色温分段控制选择LSC profile(示例见图LSC-色温控制曲线):当m_nProfileSelectOption设置为0时有效。色温位于[0,CTIndex[0]]区间,认定为低色温区间,使用LSCProfile[0]的补偿表;色温位于[CTIndex[0],CTIndex[1]]区间,使用LSCProfile[0]与LSCProfile[1]插值的补偿表;色温位于[CTIndex[1],CTIndex[2]]区间,认定为中色温区间,使用LSCProfile[1]的补偿表;色温位于[CTIndex[2],CTIndex[3]]区间,使用LSCProfile[1]与LSCProfile[2]插值的补偿表;色温位于[CTIndex[3],8192]区间,认定为高色温区间,使用LSCProfile[2]的补偿表;
m_pLSCProfileLSC补偿表,由LSC插件定标得到定标结果参数可依据色温调用

图 LSC-色温控制曲线

Gain-strength 示意图

自适应 color shading 参数

参数名说明建议调试特殊性
m_bLSCCSCEnable自适应color shading校正使能(CSC)用户设置
m_bAdjustCSCTblMinEnable依据R/G(B/G)最小值调节CSC表
m_nDifThr向量中值滤波后dif阈值,dif大于该值,则该块不参与计算CSC
m_nDifThrMinPerc向量中值滤波后dif阈值,dif小于DifThrMinPerc*DifThr,则计算CSC不考虑角度
m_nAngleThr向量中值滤波后角度阈值,角度大于该值,则该块不参与计算CSC
m_nDifThrVMF向量中值滤波前后dif阈值,dif大于该值,则该块不参与计算CSC
m_nAngleThrVMF向量中值滤波前后角度阈值,角度大于该值,则该块不参与计算CSC
m_nGradThrMin向量中值滤波后有效梯度最小值
m_nGradThrMax向量中值滤波后有效梯度最大值
m_nGradMaxErrorCSC估计统计值梯度与真实统计值梯度最大误差容忍值
m_nGradThrConvCSC两次计算的梯度差异门限,梯度差异小于该值,不更新CSC
m_nGradMaxCSC最大补偿强度
m_nTblAlpha收敛速度,值越大收敛越快
m_nCSCGlobalStrengthCSC全局强度
m_nEffPNumAll全图像有效块门限
m_nEffPNumHalf1/2图像有效块门限
m_nEffPNumQuarter1/4图像有效块门限
m_pEffNumRing三个ROI对应的有效块门限,ROI0为中心6x4,ROI1为中心12x8(不包含ROI0),ROI2为12x12(不包含ROI0,ROI1)
m_pCSCCTIndexCSC色温控制点,CT > CSCCTIndex[1]时CSC失效
m_pCSCLuxIndexCSC亮度控制点,Lux > CSCLuxIndex[1]时CSC失效

LSC Manual 及 frameinfo

参数名说明建议调试特殊性
m_bManualMode手动模式使能:1: 打开手动模式,此时LSC参数不随色温变化,使用manual参数,用于debugDebug参数
m_nLSCStrengthManual手动模式参数, 具体功能和自动功能一致Debug参数
m_pLSCProfileManual手动模式参数, 具体功能和自动功能一致Debug参数
m_nRGPolyCoefRO当前CSC补偿R ratio只读
m_nBGPolyCoefRO当前CSC补偿B ratio只读
m_pRGRatio16x12 统计块对应R/G ratio只读
m_pBGRatio16x12 统计块对应B/G ratio只读
m_pOTPProfileInternalOTP shading表只读

CDemosaicFirmwareFilter 调试说明

CDemosaicFirmwareFilter(Demosaic)模块用于 Bayer 插值。

Demosaic 子功能使能

参数名说明建议调试特殊性
m_bIfEdgeGenerate高频信息生成功能开关:可用于inline sharpen(inline sharpen功能需要cmc模块配合使用) 0:关闭 1:打开用户设置
m_bIfGbGrRebalanceGbGr差异消除功能开关0:关闭 1:打开
m_bIfDNSinline 去噪功能开关, 建议关闭0:关闭 1:打开

Demosaic 动态控制参数

Demosaic 参数可随 gain 动态调节。

增益控制节点 N 从 0-11,共十二组,节点为 2 的 N 次方倍 gain,即第 0 档为 1 倍 gain;第 11 档为 2048 倍 gain。

参数名说明建议调试特殊性
m_nInterpOffset四方向噪声容忍度可随Gain变化
m_nInterpOffsetHV水平垂直噪声容忍度可随Gain变化
m_nNoiseSTD噪声容忍度标准差可随Gain变化
m_nLowpassGLevel插值频率控制参数, 越小越倾向于4方向插值结果, 越大越倾向于无方向低通插值的结果可随Gain变化
m_nGbGrThrGbGr差异消除功能对应的阈值,越小GbGr差异消除功能越弱, 反之则越强可随Gain变化
m_nSharpenStrength高频信息放大倍率,值越大,锐化越强可随Gain变化
m_nShpThreshold高频信息软阈值处理时的阈值, 建议保持缺省值可随Gain变化
m_nDenoiseThresholdinline 去噪功能软阈值, 越大去噪能力越强, 建议保持缺省值可随Gain变化
m_nNoiseAddbackLevelinline 去噪功能噪声回加强度, 越大去噪能力越弱, 建议保持缺省值可随Gain变化
m_pDenoiseLumaStrength依据亮度控制去噪强度缩放系数,亮度区间为8bit下[8,16,32],亮度64以上系数为32,不缩放可随Gain变化
m_nChromaNoiseThreshold去除彩噪功能阈值, 越大去除彩噪能力越强, 建议保持缺省值可随Gain变化
m_pUSMFilterUSMFilter = conv([1 2 1], [usm2 usm1 usm0 64-2*(usm0+usm1+usm2) usm0 usm1 usm2]), 建议保持缺省值可随Gain变化

以 m_nSharpenStrength 为例:

Column 表示 Gain 的档位,Column[0]表示 1 倍 gain 下对应的值;Column[11]表示 2048 倍 gain 下对应的值

Gain – Sharpen 示意图

Demosic 其他参数

参数名说明建议调试特殊性
m_pHFFragShiftIndex高频信息分段增益处理的分段信息, 建议保持缺省值
m_pHFFragGainIndex高频信息分段增益处理的增益信息, 建议保持缺省值

Demosaic Manual 参数

参数名说明建议调试特殊性
m_bManualMode手动模式使能 0: 自动模式1: 手动模式,此时demosaic参数不随gain变化,使用manual参数,用于debug-Debug参数
Manual结尾参数手动模式参数, 具体功能和自动功能一致-Debug参数

CRawDenoiseFirmwareFilter 调试说明

CRawDenoiseFirmwareFilter(RawDenoise)模块用于 RAW 域去噪。

RawDenoise 使能

参数名说明建议修改特殊性
m_bEnableRAW denoise 模块使能开关0: 关闭RAW域去噪 1: 打开RAW域去噪依据用户设置

RawDenoise 动态控制参数

RawDenoise 参数可随 gain 动态调节。

增益控制节点 N 从 0-11,共十二组,节点为 2 的 N 次方倍 gain,即第 0 档为 1 倍 gain;第 11 档为 2048 倍 gain.(见 Gain-Denoise_strength 示意图)

参数名说明建议修改特殊性
m_pMaxSpacialDenoiseThreGain边角最大去噪强度, Q8精度, 值越大, 边角能达到的去噪强度越强可随Gain变化
m_pSigma去噪强度阈值, 值越大去噪强度越强可随Gain变化
m_pGnsG通道去噪强度, 值越大去噪强度越强可随Gain变化
m_pRbnsRB通道去噪强度, 值越大去噪强度越强可随Gain变化
m_pL0对应1.5%亮度下的去噪强度伸缩系数, Q5精度, 值越大, 该亮度下去噪强度越强可随Gain变化
m_pL1对应7.8%亮度下的去噪强度伸缩系数, Q5精度, 值越大, 该亮度下去噪强度越强可随Gain变化
m_pL2对应20%亮度下的去噪强度伸缩系数, Q5精度, 值越大, 该亮度下去噪强度越强可随Gain变化
m_pL3对应45%亮度下的去噪强度伸缩系数, Q5精度, 值越大, 该亮度下去噪强度越强可随Gain变化

m_pL0 - m_pL3 对应不同亮度下的去噪强度

luma-strength

以 m_pSigma 为例:

Column 表示 Gain 的档位,Column[0]表示 1 倍 gain 下对应的参数;Column[11]表示 2048 倍 gain 下对应的参数;

Gain - Denoise_strength 示意图

RawDenoise 功能模块及参数

参数名说明建议修改特殊性
m_bMergeEnable计算去噪权重时2x2->1x1的转换方式0: 取左下角, 1: 取2x2的均值
m_bLocalizedEnable去噪强度跟随局部亮度变化功能使能1. - 关闭2. - 打开
m_bSpacialEnable边缘去噪强度增强使能:0:关闭 1:打开依据用户设置
m_bSpacialAddbackEnable边缘去噪回加使能:0:关闭 1:打开依据用户设置
m_nSpacialOffCenterPercentage边缘去噪增强区域控制参数,去噪强度从Centerpercentage*R开始增强 (见R – CenterPercent示意图)
m_pMaxSpacialDenoiseThreGain边缘去噪最大增强门限,最远距离所能达到的最大去噪强度(见Distance – RadialGain示意图)

R - CenterPercent 示意图

Distance - RadialGain 示意图

RawDenoise debug 参数

参数名说明建议修改特殊性
m_bManualMode手动模式使能 0: 自动模式1: 打开手动模式,此时raw denoise参数不随gain变化,使用manual参数,用于debug
m_nSigmaManual手动模式参数,作用和自动一致
m_nGnsManual手动模式参数,作用和自动一致
m_nRbnsManual手动模式参数,作用和自动一致
m_nL0Manual手动模式参数,作用和自动一致
m_nL1Manual手动模式参数,作用和自动一致
m_nL2Manual手动模式参数,作用和自动一致
m_nL3Manual手动模式参数,作用和自动一致

CAFMFirmwareFilter 参数说明

CAFMFirmwareFilter 模块用于自动对焦统计模块。

AFM 使能

参数名说明建议调试特殊性
m_bEnableAFM使能0: 关闭自动对焦统计模块 1: 打开自动对焦统计模块用户设置

AFM 参数

参数名说明建议调试特殊性
m_nAFStatModeAF统计模块模式:0:经过白平衡 1:不经过白平衡
m_nWinStartXPermilAFM水平方向起始点坐标千分比用户设置
m_nWinStartYPermilAFM垂直方向起始点坐标千分比用户设置
m_nWinEndXPermilAFM水平方向结束点坐标千分比用户设置
m_nWinEndYPermilAFM垂直方向结束点坐标千分比用户设置
m_nMinWidthPermilAFM最小宽度千分比用户设置
m_nMinHeightPermilAFM最小高度千分比用户设置
m_bConfigDoneFW控制参数,AF窗口设置完成时设1
m_pFVList各对焦窗口Focus value值-只读
m_nFVAvgFocus value平均值-只读
m_nWinStartXAFM水平方向起始点坐标-只读
m_nWinStartYAFM垂直方向起始点坐标-只读
m_nWinWidthAFM宽度-只读
m_nWinHeightAFM高度-只读

CPDCFirmwareFilter 参数说明

CPDCFirmwareFilter 模块用于将 PD 像素或 shadow 像素补偿至正常亮度供 PDAF 算法使用。

PDC 使能

参数名说明建议调试特殊性
m_bEnablePDC使能:0: 关闭PDC模块 1: 打开PDC模块用户设置

PDC 参数

参数名说明建议调试特殊性
m_bOutPD dump使能0: 关闭dump窗口内所有PD点 1: 打开dump窗口内所有PD点
m_nHOffset水平方向ISP处理图像相对于sensor输出图像宽度的偏移量(见窗口示意图m_nHOft)
m_nVOffset垂直方向ISP处理图像相对于sensor输出图像高度的偏移量(见窗口示意图m_nVOft)
m_bLRAdjust方向控制:0: 关闭镜像 1: 打开镜像
m_bTBAdjust方向控制:0: 关闭翻转 1: 打开翻转
m_nFullWidthsensor输出图像宽度
m_nFullHeightsensor输出图像高度
m_nWindowMode窗口模式:0: 自动计算PD dump区域;1: 通过m_nWinStartXPermil,m_nWinStartYPermil, m_nWinEndXPermil 和EndYPermil计算PD dump区域;
m_nWindowScaleFactorPDC统计窗相对于AFM统计窗的缩放比例用户设置
m_nMinWidthPermilPDC统计窗最小宽度千分比用户设置
m_nMinHeightPermilPDC统计窗最小高度千分比用户设置
m_pPDFirstX水平方向PD区域相对于sensor输出图像宽度的偏移量(见窗口示意图)
m_pPDFirstY垂直方向PD区域相对于sensor输出图像高度的偏移量(见窗口示意图)
m_pRatioA四通道全局调节比例
m_pPixelMask32x32的区域内PD点的分布
m_pPixelTypeMask32x32的区域内PD点类型的分布PD点类型分为遮蔽上下左右四种
m_pRatioBMap四通道PD点补偿系数
m_bSoftCompEnable软件补偿PD亮度差异开关:0:使用硬件PDC补偿 1:软件补偿(sensor抽出PD像素)
m_nWinStartXPermil水平方向PD dump区域左上角坐标千分比-只读
m_nWinStartYPermil垂直方向PD dump区域左上角坐标千分比-只读
m_nWinEndXPermil水平方向PD dump区域右下角坐标千分比-只读
m_nWinEndYPermil垂直方向PD dump区域右下角坐标千分比-只读
m_nWinStartXPDC统计窗水平方向起始点坐标-只读
m_nWinStartYPDC统计窗垂直方向起始点坐标-只读
m_nWinWidthPDC统计窗宽度-只读
m_nWinHeightPDC统计窗高度-只读

窗口示意图

CPDFFirmwareFilter 参数说明

CPDFFirmwareFilter 模块用于将 PD 像素矫正到正常像素值。

PDF 使能

参数名说明建议调试特殊性
m_bEnablePDF使能0: 关闭相位对焦像素矫正 1: 打开相位对焦像素矫正用户设置

PDF 参数

参数名说明建议调试特殊性
m_nExtPRmPD像素奇异点矫正使能0: 关闭PD像素奇异点矫正 1: 打开PD像素奇异点矫正用户设置
m_nWA中心块权重8为50%权重,一般中心点本身是被补偿的PD点,故权重一般设小一些。
m_nWB对角块权重8为50%权重,一般设为50%
m_nFullWidthsensor输出图像宽度
m_nFullHeightsensor输出图像高度
m_nHOffset水平方向ISP处理图像相对于sensor输出图像宽度的偏移量(见窗口示意图m_nHOft)
m_nVOffset垂直方向ISP处理图像相对于sensor输出图像高度的偏移量(见窗口示意图m_nVOft)
m_bLRAdjust方向控制:0: 关闭镜像 1: 打开镜像
m_bTBAdjust方向控制:0: 关闭翻转 1: 打开翻转
m_bRefRB0: 绿色通道矫正不参考RB通道 1: 绿色通道矫正参考RB通道
m_bRefCnr0: 绿色通道矫正不参考角点信息 1: 绿色通道矫正参考角点信息
m_nRefNoiseL用于判断边缘方向的当前噪声水平
m_nExtPThrePD像素奇异点的门限
m_nExtPSftPD像素奇异点的软阈值
m_nExtPOptPD像素奇异点矫正选择
m_pPDFirstX水平方向PD区域相对于sensor输出图像宽度的偏移量(见窗口示意图)
m_pPDFirstY垂直方向PD区域相对于sensor输出图像高度的偏移量(见窗口示意图)
m_pPixelMask32x32的区域内PD点的分布
m_pPDResult四方向 PD shift 与 confidence只读

CPDAFFirmwareFilter 参数说明

CPDAFFirmwareFilter 模块用于相位对焦。

PDAF 查找表

参数名说明建议调试特殊性
m_bMirrorShift输出相位差取反用户设置
m_bShiftLutEn查找表使能用户设置
m_pShiftLut输出相位差查找表

PDAF 误差控制

参数名说明建议调试特殊性
m_nErrorDistWeight误差来源的权重(见相关性拟合曲线示意图)0 表示shape的权重为1;128 表示 shape和distance各占一半;256 表示distance的权重为1;
m_nErrorDistCoefdistance(相关性拟合曲线距离)调节系数
m_nErrorShpCoefshape(相关性拟合曲线形状)调节系数

相关性拟合曲线示意图

PDAF 动态控制参数

参数名说明建议调试特殊性
m_pLumThre不同gain下的亮度阈值,(见图LumThre-gain控制曲线)当前亮度低于阈值时,置信度会降低依据gain调整
m_pGainThre划分不同gain的区间的依据,用于依据Gain控制LumThre和SwingThre
m_pSwingThre不同Gain下的幅度门限,(见图SwingThre-gain控制曲线)当前幅度值低于此门限时,置信度会降低依据gain调整

图 LumThre-Gain 控制曲线

图 SwingThre-Gain 控制曲线

PDAF 置信度控制参数

参数名说明建议调试特殊性
m_bConfAdjust置信度适配开关:1 :当前幅度值高于此门限时,置信度增大0 :当前幅度值高于此门限时,置信度不变
m_nConfOff置信度offset,用于调整最终置信度
m_nConfLimit最大置信度(见图Error-Confidence转换曲线)
m_nErrorThre1误差转为置信度的error门限(见图Error-Confidence转换曲线)
m_nErrorThre2误差转为置信度的confidence门限(见图Error-Confidence转换曲线)
m_nSearchRangePD shift搜索范围,PD像素密度越大,该值越大。一般密度shield pixel设0,Dual PD设3,

图 Error-Confidence 转换曲线

CWbFirmwareFilter 参数说明

CWbFirmwareFilter 模块用于白平衡。

WB 使能

参数名说明建议调试特殊性
m_bEnableWB使能0: 关闭白平衡统计模块 1: 打开白平衡统计模块

WB 参数

参数名说明建议调试特殊性
m_bSyncWBHDR模式白平衡同步方式选择:0:AWB单独计算 1:使用长曝光作为AWB计算源
m_bAutoWindow窗口调整方式:0:固定窗口大小 1:依据zoom系数自动计算窗口大小
m_nMode白平衡模式选择:0: auto mode 1:custom 2:D75 3:D65 4:D50 5:CWF 6:TL84 7:A 8:H 9:lock
m_nInitMode白平衡初始化模式:0:custom 1:D75 2:D65 3:D50 4:CWF 5:TL84 6:A 7:H
m_pManualGain手动WB gain:0-7 对应 custom/D75/D65/D50/CWF/TL84/A/H
m_nAWBStableRangeAWB 进入稳定状态的门限:值越小,越不容易判定为AWB稳定
m_nAWBStableFrameNumAWB 进入稳定状态的参考帧数:稳定帧数大于改值,判定为AWB稳定
m_nAWBUnStableRangeAWB 进入不稳定状态的门限:值越小,越容易判定为AWB不稳定
m_nAWBUnStableFrameNumAWB 进入不稳定状态的参考帧数:不稳定帧数大于改值,判定为AWB不稳定
m_nAWBStep1AWB 收敛的相对步长按比例计算步长,值越大,调整的比例越大,收敛的越快,准确性越低
m_nAWBStep2AWB 收敛的绝对步长值越大,步长越大,调整的越快,准确性越低
m_nLowThr参与AWB统计的亮度下限值越大,越多偏暗的区域不进行AWB统计
m_nHighThr参与AWB统计的亮度上限值越小,越多偏亮的区域不进行AWB统计
m_nCorrelationCT当前色温-只读
m_nTint当前色调-只读
m_bAWBStableFlagAWB当前状态-只读
m_nDistance当前应用的白平衡gain与target gain 差的绝对值之和-只读

CCTCalculatorFilter 参数说明

CCTCalculatorFilter 模块用于计算真实色温。

CCTCalculator 参数

参数名说明建议调试特殊性
m_nIterateNumber计算CT的迭代次数
m_nColorTemperatureLow低色温矩阵对应色温
m_nColorTemperatureHigh高色温矩阵对应色温
m_pCTMatrixLow低色温矩阵定标结果
m_pCTMatrixHigh高色温矩阵定标结果

CRGB2YUVFirmwareFilter 参数说明

CRGB2YUVFirmwareFilter 模块用于 RGB 转 YUV。

RGB2YUV 参数

参数名说明建议调试特殊性
m_nOutputColorSpace输出色彩空间选择:0:Rec.601, 1:Rec.709用户设置
m_nGlobalSaturation全局饱和度系数,Q7精度
m_pSaturationCP饱和度随gain控制参数(示例见图sat_CP-gain控制曲线)可随gain变化

RGB2YUV Manual 参数

参数名说明建议调试特殊性
m_bManualMode手动模式使能:0:自动模式,饱和度可随gain变化 1:手动模式,饱和度固定为manual所设系数Debug参数
m_nSaturationManual手动饱和度系数,Q7精度Debug参数

图 sat_CP-gain 控制曲线

CSpecialEffectFirmwareFilter 参数说明

CSpecialEffectFirmwareFilter 模块用于特殊效果调试。

SE 使能

参数名说明建议调试特殊性
m_bEnableSpecial effect使能0: 关闭特殊效果 1: 打开特殊效果共6个控制区域,区域0-5优先级逐渐降低用户设置
SE 参数

参数分为区域 0-5,共 6 组,每组含义一样,针对 6 个控制区域,区域 0-5 优先级逐渐降低。

参数名说明建议调试特殊性
m_bZoneEb_0区域0 特效使能用户设置
m_pRyTable_0亮度旋转参数,定标参数定标结果参数
m_nSyTable_0亮度平移参数,定标参数定标结果参数
m_pRuvTable_0UV旋转参数,定标参数定标结果参数
m_pSuvTable_0UV平移参数,定标参数定标结果参数
m_pMargin_0渐变过渡带[Lum_min - Margin_0[0],Lum_max + Margin_0[1] 是平滑区间; [Hue_min - Margin_0[2],Hue_max + Margin_0[3] 是平滑区间; [Sat_min - Margin_0[4],Sat_max + Margin_0[5] 是平滑区间;
m_pYTable_0目标调整区域的Lum范围
m_pHTable_0目标调整区域的Hue范围
m_pSTable_0目标调整区域的Saturation范围

SE 动态控制参数

GainWeight_0-5 共用一组 GainLut,用于针对不同亮度区间设置不同的强度。

参数名说明建议调试特殊性
m_nGainLutGainWeight分段点,对应实际场景的值为exposure_time(us)*total_gain(Q8)>>8
m_pGainWeight_0特殊效果的强度,(见图GainWeight-GainLut控制曲线)值越大,特殊效果越强可依据Gainlut变化

SE Manual 参数

参数分为区域 0-5,共 6 组,每组含义一样

参数名说明建议调试特殊性
m_bManualMode_0区域0 手动模式使能-Debug参数
m_nManualGainWeight_0手动模式下特殊效果的强度-Debug参数

CCurveFirmwareFilter 参数说明

CCurveFirmwareFilter 模块用于伽马曲线。

Curve 使能

参数名说明建议调试特殊性
m_bEnableCurve使能0: 关闭伽马曲线 1: 打开伽马曲线用户设置

Curve 控制参数

参数名说明建议调试特殊性
m_bEbGtmAfterLinearcurveGTM随线性曲线改变使能:0:gtm1 curve不变, 1:gtm1 curve 随线性曲线改变
m_nCurveSelectOptionCurve使用选择:0: 基于gain自动计算, 1:使用GTMcurve0, 2:使用GTMcurve1, 3:使用 GTMcurve2 4:使用A-Log curve
m_nBacklightStrengthManual低亮区域亮度调节参数:值越大,低亮区域的亮度提供的越多,0表示不增强低亮区域,此时BacklightCurveManu al不作用于最终的曲线用户设置
m_nContrastStrengthManual对比度调节参数:值越大,对比度越高,128表示不调节对比度,此时ContrastsCurveManual不作用于最终的曲线用户设置
m_nBrightnessStrengthManual亮度调节参数:值越大,整体亮度越高,4096表示一倍用户设置
m_nAlpha前后帧GTM曲线融合的迭代速度。m_nAlpha值越大,越快收敛到当前帧计算得到的GTM曲线,255表示立即收敛到当前帧曲线。
m_pBacklightCurveManual用于调节低亮区域的曲线
m_pContrastsCurveManual用于调节对比度的曲线
m_pGainIndexGain分段控制点(见Curve-Gain控制曲线示意图) 色温分段控制点。(见Curve-Gain控制曲线示意图)gain位于[128,GainIndex[0]]区间,使用GTMCurve0的曲线;gain位于[GainIndex[0],GainIndex[1]]区间,使用GTMCurve0与GTMCurve1插值的曲线; gain位于GainIndex[2],使用GTMCurve1的曲线;gain位于[GainIndex[1],GainIndex[2]]区间,使用GTMCurve1与GTMCurve2插值的曲线;gain位于[GainIndex[2],2048]区间,使用GTMCurve2的曲线;
m_pGTMCurve0曲线0可依据Gain调用
m_pGTMCurve1曲线1可依据Gain调用
m_pGTMCurve2曲线2可依据Gain调用

Curve-Gain 控制曲线示意图

CLTMFirmwareFilter 参数说明

CLTMFirmwareFilter 模块用于局部色调映射。

LTM 使能

参数名说明建议调试特殊性
m_bEnableLTM使能:0: 关闭局部色调映射 1: 打开局部色调映射用户设置
m_bHistEnableLTM 直方图使能:0: 关闭LTM 直方图 1: 打开LTM 直方图
m_nOffsetY图像水平方向偏移,由输入图像大小确定用户设置
m_nOffsetX图像垂直方向偏移,由输入图像大小确定用户设置

LTM 参数

参数名说明建议调试特殊性
m_nLtmStrengthLtm强度,值越大,Ltm效果越强
m_nCurveAlpha当前帧计算得到的曲线与历史保存曲线进行融合的收敛速度,值越小,收敛越快
m_nSlopeThrDrcDrcDark < Thr,等效于GTM;DrcDrcDark >= Thr,每个块单独计算LTM强度
m_nPhicBetaLTM曲线衰减控制点,值越小,曲线越早衰减,越多中高亮的块不会提亮(PhicBeta示意图)
m_nBlendCurveFP根据DRCGain和DrcGainDark计算gtm曲线,BlendCurveFP和BlendCurveSP为两个控制节点,BlendCurveFP<=BlendCurveSP。第一个节点FP之前,tone mapping强度与 DRCGain*DrcGainDark有关。BlendCurveFP越大,暗区提亮范围越大。
m_nBlendCurveSP第二个节点SP之后,tone mapping强度与DRCGain有关,两个节点之间平滑过渡。BlendCurveSP越小,亮度提升范围越小。
m_nSubDarkPercThrLow次暗区提亮调整参数,值越小,次暗区提亮强度越大。
m_nSubDarkPercThrHigh次暗区提亮调整参数,值越小,次暗区提亮强度越大。SubDarkPercThrLow < SubDarkPercThrHigh
m_nSubDarkAdjMeanThr次暗区提亮调整参数,SubDarkPercThrLow,SubDarkPercHigh和SubDarkAdjMeanThr与块的次暗区的点占所有点的百分比,控制次暗区LTM强度。如果当前块均值大于SubDarkAdjMeanThr并且当前块次暗区百分比大于SubDarkPercThrLow,则会提高次暗区LTM强度。当次暗区百分比达到SubDarkPercThrHigh,次暗区LTM强度最大。
m_nDarkPercThrLow暗区提亮调整参数,值越小,暗区LTM强度越大。
m_nDarkPercThrHigh暗区提亮调整参数,值越小,暗区LTM强度越大。DarkPercThrLow < DarkPercThrHigh。
m_nPhCDarkMaxExtraRatio暗区提亮调整参数,DarkPercThrLow,DarkPercThrHigh和PhCDarkMaxExtraRatio与block的最暗区占所有点的百分比,控制暗区LTM强度。当前块暗区百分比大于DarkPercThrLow,则会提高暗区LTM强度,当最暗区百分比达到DarkPercThrHigh,暗区LTM强度最大。PhCDarkMaxExtraRatio越大,暗区LTM强度越大。
m_pDstAlphaGainIndexLTM强度gain控制节点
m_pDstAlphaIndex依据DstAlphaGainIndex控制节点调整LTM强度:值越大,LTM强度越大

PhicBeta 示意图

CUVDenoiseFirmwareFilter 参数说明

CUVDenoiseFirmwareFilter 模块用于去除颜色噪声。

UVDenoise 使能

参数名说明建议调试特殊性
m_bEnableUVDenoise使能建议使用CPP去噪

CEELiteFirmwareFilter 参数说明

CEELiteFirmwareFilter 模块用于控制边缘增强。

EE 使能

参数名说明建议调试特殊性
m_bEnableEE使能用户设置

CEELite 参数

参数名说明建议调试特殊性
m_pCurveLumaP正边基于亮度自适应增强,值越大边越强
m_pCurveLumaN负边基于亮度自适应增强,值越大边越强
m_pCurveFreqTxP正边基于频率自适应增强,值越大纹理越多
m_pCurveFreqTxN负边基于频率自适应增强,值越大纹理越多
m_nNodeFreq频率调节节点
m_pGlobal_SharpenStrengthP正边全局增强,值越大边越强
m_pGlobal_SharpenStrengthN负边全局增强,值越大边越强
m_pGlobal_SharpenStrengthPCapture拍照参数,正边全局增强,值越大边越强
m_pGlobal_SharpenStrengthNCapture拍照参数,负边全局增强,值越大边越强
m_pLPF1USMFilter滤波器参数
m_pLPF2USMFilter滤波器参数USMFilter = conv([(flt1[0]-flt2[0]) (flt1[1]-flt2[1]) 2*(flt2[0]+flt2[1] - flt1[0]-flt1[1]) (flt1[1]-flt2[1]) (flt1[0]-flt2[0])])
m_pLPF1Capture拍照参数,USMFilter滤波器参数
m_pLPF2Capture拍照参数,USMFilter滤波器参数USMFilter = conv([(flt1[0]-flt2[0]) (flt1[1]-flt2[1]) 2*(flt2[0]+flt2[1] - flt1[0]-flt1[1]) (flt1[1]-flt2[1]) (flt1[0]-flt2[0])])
m_pFreqExpLevel1低频区间频率分段控制,值越大,分段越密
m_pFreqExpLevel2高频区间频率分段控制,值越大,分段越密
m_pFreqOffsetTx频率软阈值,值越大,抗噪水平越强
m_pTxClipP纹理区域正边锐化截断处理,值越大,锐化越强
m_pTxClipN纹理区域负边锐化截断处理,值越大,锐化越强
m_pTxThrdP纹理区域正边锐化门限,值越小,锐化越强
m_pTxThrdN纹理区域负边锐化门限,值越小,锐化越强
m_pClipPos正边锐化截断处理,值越大,锐化越强
m_pClipNeg负边锐化截断处理,值越大,锐化越强
m_pHCStrength边沿halo强度控制,值越小,halo抑制越强
m_pCoffWHalo区域判定参数
m_pGainIndex增益控制节点(Q4)

EE Manual 参数

参数名说明建议调试特殊性
m_bManualMode手动模式使能-Debug参数
Manual结尾参数手动模式参数,与自动一致-Debug参数

CBitDepthCompressionFirmwareFilter 参数说明

CBitDepthCompressionFirmwareFilter 模块用于降位深压缩。

Dithering 使能

参数名说明建议调试特殊性
m_bEnableDitheringDithering使能0: 关闭Dithering 1: 打开Dithering

CFormatterFirmwareFilter 参数说明

CFormatterFirmwareFilter 模块用于输出格式控制。

Formatter 参数

参数名说明建议调试特殊性
m_nOutputFormat输出格式:0: NV12 1: P010 2:RGB888
m_nSwingOption0: full swing, 1: studio swing
m_bConvertDitheringEnable0: rgb2yuv dithering disable, 1: rgb2yuv dithering enable
m_bCompressDitheringEnable0: full swing to studio swing dithering disable, 1: full swing to studio swing dithering enable

CEISFirmwareFilter 参数说明

CEISFirmwareFilter 模块用于电子防抖。

EIS 使能

参数名说明建议调试特殊性
m_bEnableEIS使能0: 关闭EIS计 1: 打开EIS用户设置
EIS 参数
参数名说明建议调试特殊性
m_bCalcEnableFirmware计算使能0: 关闭 1: 打开用户设置
m_bFilterEnable运动平滑滤波使能0: 关闭运动平滑滤波(一般设备与场景相对运动较少时关闭) 1: 打开运动平滑滤波
m_nRangeXX方向检测移动的范围(单位为像素)
m_nRangeYY方向检测移动的范围(单位为像素)
m_nMarginXLDC crop窗口的offset X
m_nMarginYLDC crop窗口的offset Y
m_pFilterWeight运动平滑滤波权重
m_pPeakConfLevel置信度等级
m_pPeakErrorThre置信度等级对应误差容忍门限
m_bReverseDirectionX水平方向反转控制
m_bReverseDirectionY垂直方向反转控制
m_nCenterStatRatio中心统计比例,256为100%

CAECFilter 参数说明

CAECFilter(AEC)模块用于自动曝光控制。

AE 基础参数

参数名说明建议调试特殊性
m_bManualAEEnableAEC模式选择:0:自动模式1:手动模式,此时曝光值使用manual参数2:锁定模式,此时曝光值锁定,不受AEC调节3:手动曝光index,此时曝光锁定为m_pExpIndexManual用户设置
m_pMinExpTime最小曝光时间(参数注释包含short部分均为reserverd,以下AE参数适用此规则)
m_pMaxExpTime最大曝光时间
m_pMinAnaGain最小模拟增益
m_pMaxAnaGain最大模拟增益
m_pMinSnsDGain最小sensor数字增益
m_pMaxSnsDGain最大sensor数字增益
m_pMinTotalGain最小总体增益
m_pMaxTotalGain最大总体增益
m_pRouteNode50Hz50Hz曝光表,第一列为曝光时间,第二列为总体增益,第三列为精确增益控制(reserverd)
m_pRouteNode60Hz60Hz曝光表,第一列为曝光时间,第二列为总体增益,第三列为精确增益控制(reserverd)
m_pMeteringMatrix16x12测光权重表用户设置
m_bLumaCalcModeLuma计算方式 0:RGB max 1:Y average用户设置
m_bQuickResponseEnableAE快速响应开关,使能时立刻调节AE用户设置

AE 目标亮度控制

参数名说明建议调试特殊性
m_bAdvancedAECEnable目标亮度控制参数0:使用m_pTargetRange[1]作为目标亮度1:动态计算目标亮度,目标亮度区间[m_pTargetRange[0], m_pTargetRange[1]]用户设置
m_nCompensation目标亮度补偿系数,100为一倍
m_nSensitivityRatio拍照与预览感光度比,256为一倍用户设置
m_pSatRefBin饱和点参考值,Target约束为直方图[m_pSatRefBin[0],255]之间的像素占比落入[m_pSatRefPerThr [0][0]/10000)%, m_ pSatRefPerThr [0][1]/10000)%]
m_pSatRefPerThr饱和点占比上下限
m_pExpIndexThre曝光门限,与四组m_pLumaBlockWeight对应,用于选择哪组m_pLumaBlockWeight参与计算权重,(见Exp_index-luma_weight示意图)用户设置
m_pLumaBlockWeight四组亮度块权重表,每组中Weight[i][0]对应low_luma; Weight[i][1]对应mid_luma;Weight[i][2]对应high_luma; (见Exp_index-luma_weight示意图/Luma-Weight示意图)用户设置
m_pLumaBlockThre亮度块门限,用于控制亮度块的权重曲线(Luma-Weight示意图)用户设置
m_pLuma7ZoneWeight统计窗口与 6个sub ROI权重表用户设置
m_pTargetRange目标亮度门限
m_pTargetDeclineRatio目标亮度随gain调整参数,gain的节点为2的N次方可随Gain变化

Exp_index – luma_weight 示意图

Luma – weight 示意图

AE 模式控制

参数名说明建议调试特殊性
m_bLumaSelectOption0:亮度计算不参考AEM中的6个sub ROI1:亮度计算参考AEM中的6个sub ROI
m_nStrategyModeAE调整策略选择:0:自动模式1:高光优先,即优先保证高亮部分曝光适合2:低光优先,即优先保证低亮部分曝光适合
m_bAntiFlickerEnable去抖使能:0:关闭去抖动,此时曝光时间不受灯光闪烁限制1:使能去抖动,此时曝光时间限制为灯光闪烁周期的整数倍
m_nAntiFlickerFreq去抖频率选择:0:50Hz 1:60Hz

AE 收敛控制

参数名说明建议调试特殊性
m_nTolerance目标亮度误差容忍度,统计亮度处于[target±m_nTolerance]时AE将不做调整
m_nStableRange稳定亮度区间:当AE收敛时,若统计亮度(mean)与目标亮度(target)的差值大于m_nStableRange,则调整模拟增益用于补偿
m_nSmoothnessAE收敛平滑度调节,值越小,收敛越平滑
m_pStableRefFrame稳定参考帧数,当稳定帧数大于m_pStableRefFrame,AE认为当前场景AE稳定
m_pUnStableRefFrame不稳定参考帧数,当不稳定帧数大于m_pUnStableRefFrame,AE认为当前场景AE不稳定
m_nDualTargetBlendWeight上一次目标亮度与当前目标亮度融合比例,8为1:1;16表示全用当前目标亮度
m_pFastStep大步长调整折扣比例, m_pFastStep=256(且不受MaxFastRatio钳制时)表示一步调整到target(见step-target示意图)
m_pFastStepRangePer大步长门限,满足下述条件使用大步长current_luma – target_luma> m_nFastStepRangePer*target_luma
m_pFastStepMinRange大步长门限下限值
m_pSlowStep小步长调整折扣比例,(同m_pFastStep,见step-target示意图)
m_pSlowStepRangePer小步长门限,满足下述条件使用小步长m_nSlowStepRangePer*target <current_luma – target< m_nFastStepRangePer*target
m_pSlowStepMinRange小步长门限下限值
m_pFineStep细步长调整折扣比例,(同m_pFastStep,见step-target示意图)
m_pMaxFastRatio最大大步调整比例(Q8):增曝光时,最大大步调整比例为m_pMaxFastRatio;减曝光时,最大大步调整比例为65536/m_nMaxFastRatio;
m_pMaxSlowRatio最大小步调节比例(Q8):增曝光时,小步调节比例限制区间[256 + m_nMaxFineRatio, 256 + m_nMaxSlowRatio];减曝光时,小步调节比例限制区间[256 - m_nMaxSlowRatio, 256 - m_nMaxFineRatio];
m_pMaxFineRatio最大细步调节比例(Q8)
m_pMinFineRatio最小细步调节比例增曝光时,小步调节比例限制区间[256 + m_nMinFineRatio, 256 + m_nMaxFineRatio];减曝光时,小步调节比例限制区间[256 - m_nMaxFineRatio, 256 - m_nMinFineRatio];
m_pAjustSplitFrameNum单步调整所需次数(第1列reserved)
m_pSingleStepAdjustLumaThr单次调节亮度阈值(第1列reserved),与m_pAjustSplitFrameNum共同决定单次调节最大luma值Single_luma_max = max((target - mean)/AjustSplitFrameNum,SingleStepAdjustLumaThr)(增曝光时,若依据adjustRatio调整的luma超过Single_luma_max,则adjustRatio= 256 + Single_luma_max 256 / mean )(减曝光时,若依据adjustRatio调整的luma超过Single_luma_max,则adjustRatio= 256 - Single_luma_max 256 / mean )
m_pFaceAjustSplitFrameNum参数含义同m_pAjustSplitFrameNum,face AE模式下有效
m_pFaceSingleStepAdjustLumaThr参数含义同m_pSingleStepAdjustLumaThr,face AE模式下有效

Step – target 示意图

Luma – stpe 示意图

自动动态范围补偿增益计算

参数名说明建议调试特殊性
m_nDarkRefBin暗区像素亮度上限参考值,计算暗区亮度时,统计范围不会超过该值
m_bLumaPredictDRCgain计算亮度预测:0:计算DRCgain时不修正(当帧统计当帧apply LTM时)1:计算DRCgain时修正(当帧统计下帧apply LTM时)
m_nDarkPerThrL暗区像素亮度百分比下限,暗区像素数目百分比低于该值时,DRCGainDark为1,(见图示pixelNumPercent-DRCGainDark示意图)
m_nDarkPerThrH暗区像素亮度百分比上限,暗区像素数目百分比高于该值时,暗区像素全部参与计算DRCGainDark,(见图示pixelNumPercent-DRCGainDark示意图)
m_nDarkTarget暗区期望达到的亮度值,值越大 ,最终计算出的DRCGainDark越大
m_nMaxDRCGain最大DRC增益
m_nMaxDRCGainDark最大DRC Dark增益

PixelNumPercent - DRCGainDark 示意图

Lux 定标

参数名说明建议调试特殊性
m_nCalibExposureIndex亮度定标的曝光索引
m_nCalibSceneLum亮度定标的场景亮度
m_nCalibSceneLux定标场景对应的实际照度

AEC manual 参数

参数名说明建议调试特殊性
m_pExpTimeManual手动曝光时间,AEC处于手动模式时生效
m_pAnaGainManual手动模拟增益,AEC处于手动模式时生效
m_pSnsDGainManual手动sensor数字增益,AEC处于手动模式时生效
m_pTotalGainManual手动总体增益,AEC处于手动模式时生效
m_pExpIndexManual手动曝光index,AEC处于手动模式时生效

AEC frameinfo

参数名说明建议调试特殊性
m_nFrameCounterAE帧计数-只读
m_pExpTimeLong曝光时间(us)-只读
m_pAnaGainLong模拟增益(Q8)-只读
m_pSnsDGainLongsensor数字增益(Q12)-只读
m_pIspDGainLongISP数字增益(Q12)-只读
m_pTotalGainLong总增益(Q8)-只读
m_pExpIndexLong曝光索引(曝光时间 * 总增益 / 256)-只读
m_pTotalGainDBLong总增益(db)-只读
m_pExpTimeShortReserved-只读
m_pAnaGainShortReserved-只读
m_pSnsDGainShortReserved-只读
m_pIspDGainShortReserved-只读
m_pTotalGainShortReserved-只读
m_pExpIndexShortReserved-只读
m_pTotalGainDBShortReserved-只读
m_nCurHdrRatioReserved-只读
m_nHistPixelNum参与直方图统计的像素数-只读
m_pMeanLumaAE计算亮度,[0]:long, [1]: Reserved-只读
m_pTargetLumaAE目标亮度,[0]:long, [1]: Reserved-只读
m_pLuma7ZoneAE主窗口及6个副窗口luma-只读
m_pAERouteNumAE曝光节点,[0]:long, [1]: Reserved-只读
m_pRouteNodeLong长帧曝光表-只读
m_pADNodeLongSensor again与dgain分配表-只读
m_pLumaMatrixLong亮度缩略图-只读
m_pHistLong直方图-只读
m_pRouteNodeShortReserved-只读
m_pADNodeShortReserved-只读
m_pLumaMatrixShortReserved-只读
m_pHistShortReserved-只读
m_pRefSaturateNum参考过曝像素数,[0]:long, [1]: Reserved-只读
m_pCurSaturateNum当前过曝像素数,[0]:long, [1]: Reserved-只读
m_pEstSaturateNum预估过曝像素数,预估当统计亮度达到目标亮度上限时过曝像素数,[0]:long, [1]:Reserved-只读
m_pAdjustRatioAE调节比例-只读
m_pStableFlagAE稳定标志,[0]:long, [1]: Reserved-只读
m_pStableFlagBufAE帧序列稳定标志,[0]:long, [1]: Reserved-只读
m_pUnStableFlagBufAE帧序列不稳定标志,[0]:long, [1]: Reserved-只读
m_nDRCGainDRCGain当前帧AE计算结果-只读
m_nDRCGainDarkDRCGainDark当前帧AE计算结果-只读

CAFFilter 参数说明

CAFFilter 模块用于自动对焦控制。

AF 参数

参数名说明建议调试特殊性
m_nAFMode对焦模式:0:SAF 单次聚集 1:CAF 连续聚焦用户设置
m_bHybridAFEnableCDAF与PDAF混合对焦模式使能:0:关闭 1:开启用户设置
m_bAFTrigger自动对焦触发,CAF时需要使能用户设置
m_bMotorManualTrigger手动对焦触发,配合ManualMotorPosition使用用户设置
m_nManualMotorPosition手动电机位置用户设置
m_nFrameRate当前sensor帧率,用于计算AF跳帧数,建议由软件更新用户设置
m_nMaxSkipFrame最大跳过帧数

电机属性参数

参数名说明建议调试特殊性
m_nMinMotorPosition最小电机位置
m_nMaxMotorPosition最大电机位置
m_nMotorResponseTime电机走一步的响应时间(ms),用于计算AF跳帧数,值越大,跳帧数越多
m_nHyperFocalMotorPosition超焦距位置

电机运动控制参数

参数名说明建议调试特殊性
m_nFirstStepDirectionJu dgeRatio首步方向判断百分比。AF算法运行在CDAF时,判断电机走第一步的方向所需的百分比。当电机初始位置位于整个电机范围的前百分比之内时,方向为从最小电机位置到最大电机位置;当电机初始位置位于整个电机范围的后(100%-百分比)之内时,方向为从最大电机位置到最小电机位置用户设置
m_bPreMoveMode预运动模式。AF算法运行在CDAF时,电机走第一步时0:保持初始位置 1:走到最小电机位置或者最大电机位置,具体根据初始位置与首步方向判断百分比而定用户设置
m_bPreMoveToInfMode预运动模式,运动最小电机位置。AF算法运行在CDAF时,电机走第一步时0:保持初始位置 1:走到最小电机位置用户设置
m_bStartFromTrueCurrent从当前实际位置开始使能。AF算法运行在CDAF时,电机走第一步时0:走到距离初始位置最近的微距位置 1:保持初始位置用户设置
m_nBackTimeRatio电机运动时跳帧比例,值越大,电机走一步花费的帧数越多。与m_nBackTimeDivisor共同控制电机跳帧用户设置
m_nBackTimeDivisor电机运动时跳帧控制参数,值越小,电机走一步花费的帧数越多。与m_nBackTimeRatio共同控制电机跳帧用户设置
m_nPreMoveTimeRatio预运动模式下的电机跳帧比例用户设置
m_nFailMotorPositionOpt ion聚焦失败后最终位置选择:0:算法自动选择(需正确填写超焦距马达位置) 1:最清晰 2:无穷远 3:超焦距 4:微距 5:当前位置用户设置

电机步长控制参数

参数名说明建议调试特殊性
m_nMinMacroReverseStepNum当电机由最大电机位置到最小电机位置运动,检测到FV下降需要反向时,电机必须走过的步数
m_nMinReverseStepNum当电机由最小电机位置到最大电机位置运动,检测到FV下降需要反向时,电机必须走过的步数
m_nFineStepSearchNum细步长搜索的步数
m_nCoarseStepCDAF下粗步长
m_nFineStepCDAF下细步长
参数名说明建议调试特殊性
m_nSoftwareMotorCtrlMod e从当前位置到目标位置的电机运动模式:(一般应用于第一步预移动到最大/最小位置;手动电机位置;开始走小步;聚焦失败时等情况 )0:软着陆模式 1:固定步长模式 2:直达模式用户设置见图1
m_nMinSafePosition在软着陆模式下,电机由最大电机位置到最小电机位置移动时的最小安全位置用户设置见图2
m_nMinStepRatio在软着陆模式下,电机由最大电机位置到最小电机位置移动的最小步长比例用户设置见图2
m_nMaxSafeStep在软着陆模式下,电机由最大电机位置到最小电机位置移动的最大安全步长用户设置见图2
m_nMinSafePositionMacro在软着陆模式下,电机由最小电机位置到最大电机位置移动时的最小安全位置用户设置见图2
m_nMinStepRatioMacro在软着陆模式下,电机由最小电机位置到最大电机位置移动的最小步长比例用户设置见图2
m_nMaxSafeStepMacro在软着陆模式下,电机由最小电机位置到最大电机位置移动的最大安全步长用户设置见图2

图 1

(每组 Conditions 条件描述-Graphic 图形演示-Output 输出为一种情况)

图 2

参数名说明建议调试特殊性
m_bAdaptiveStep可变步长模式,0:不使能 1:使能用户设置
m_nVCMStep1Ratio电机步长比例1,在可变步长模式下,将电机范围划分为多个区间用户设置见图3
m_nVCMStep2Ratio电机步长比例2,在可变步长模式下,将电机范围划分位多个区间用户设置见图3
m_nVCMCoarseStep1电机粗步长1,在可变步长模式下,根据当前电机位置在不同区间计算实际步长用户设置见图3
m_nVCMCoarseStep2电机粗步长2,在可变步长模式下,根据当前电机位置在不同区间计算实际步长用户设置见图3
m_nVCMFineStep1电机细步长1,在可变步长模式下,根据当前电机位置在不同区间计算实际步长用户设置见图3
m_nVCMFineStep2电机细步长2,在可变步长模式下,根据当前电机位置在不同区间计算实际步长用户设置见图3
  • MotorMoveStep 表示实时的步长,它根据当前电机运动方向、当前处于粗步长还是细步长模式改变,是一个变量,符号可为正,可为负,可为较大值,可为较小值

图 3

(每组 Conditions 条件描述-Graphic 图形演示-Output 输出为一种情况)

Focus Value 判定参数

参数名说明建议调试特殊性
m_pFVDropPercentage预运动模式下,判定FV曲线下降的百分比。6种类型的FV各自根据增益计算
m_pCurrentStartFVDropPercentage非预运动模式下,判定FV曲线下降的百分比。6种类型的FV各自根据增益计算
m_pFVFailPercentage预运动模式下,判定FV曲线无效的最大FV值与最小FV值的差异百分比。若最大FV值与最小FV值差异小于阈值,则认为FV曲线过于平滑而无效。6种类型的FV各自根据增益计算。是判定聚焦失败的第一种条件。
m_pCurrentStartFVFailPe rcentage非预运动模式下,判定FV曲线无效的最大FV值与最小FV值的差异百分比。若最大FV值与最小FV值差异小于阈值,则认为FV曲线过于平滑而无效。6种类型的FV各自根据增益计算。是判定聚焦失败的第一种条件。
m_pLastStepChangePercentageFV曲线一直上升或一直下降判定为失效的百分比,6种类型的FV各自根据增益计算
m_pWindowWeightMatrix5x5统计窗的FV的权重

PDAF 控制参数

参数名说明建议调试特殊性
m_bPDReverseDirectionFlagPDShift计算的步长反向标志0:不反向 1:反向
m_nPDDirectConfThrRatioPD阈值百分比,当置信度大于阈值的m_nPDDirectConfThrRatio%时,直接走出PD计算的步长
m_nPDTryStepRatioAF算法运行在混合对焦模式时,首先尝试走出的一步相对于CDAF大步的比例
m_nPDCoarseStepPDAF粗步长
m_nPDFineStepPDAF细步长
m_nPDStepDiscountRatioPDAF对由PDShift计算出的步长的打折比例
m_pPDConfThrPD信息置信度阈值
m_pPDFVIncreaseRatioAF算法运行在混合对焦模式时,FV上升的比例,用于判定尝试的一步走出后FV值是否上升,从而判定PD信息是否可信
m_pPDFVDropPercentageFV值下降的判定百分比,当AF运行在PDAF下
m_pPDShiftPositionLUT_0_0m_pPDShiftPositionLUT_4_45x5窗口,PD Shift – step 查找表PDAF插件标定

连续聚焦控制

参数名说明建议调试特殊性
m_bCAFHold在连续聚焦模式下,保持当前状态不变用户设置
m_bCAFForce在连续聚焦模式下,强制触发一次单次聚焦用户设置
m_nCAFHoldPDShiftThr连续聚焦模式下,判断场景稳定的PD shift门限,值越大,越容易判断为稳定
m_nCAFHoldPDConfThr连续聚焦模式下,判断场景稳定的PD confidence门限,值越小,越容易判断为稳定
m_nPreFocusMode在连续聚焦模式下,追焦模式使能:0:不追焦 1:半追焦(基于PD shift先尝试一次对焦)用户设置
m_nPFPDStepDiscountRatioPrefocus步长折扣比
m_nLumaCalcOptLuma计算方式0:三通道分别计算 1:计算RGB最大值 2:计算加权的Y均值
m_bReFocusEnable连续聚焦模式下,refocus使能用户设置
m_pRefocusLumaSADThrCAF触发SAF时,决定是否触发的SAD门限
m_nFlatSceneVarThr连续聚焦模式下,判断是否为平坦场景的缩略图的方差门限
m_nFlatSceneLumaThr连续聚焦模式下,判断是否为平坦场景的亮度门限
m_bStableJudgeOpt连续聚焦模式下,判断场景稳定的条件:0:FV或luma满足其一 1:FV与luma均满足用户设置
m_nRefStableFrameNum在连续聚焦模式下,参考态中判定场景已经稳定的帧数用户设置
m_nDetStableFrameNum在连续聚焦模式下,检测态中判定场景已经稳定的帧数用户设置
m_pStableExpIndexPercentage在连续聚焦模式下,判定当前帧稳定的曝光量变化百分比
m_pStableFVSADPercentage在连续聚焦模式下,判定当前帧稳定的FV的SAD百分比
m_pStableLumaSADThr在连续聚焦模式下,判定当前帧稳定的亮度的SAD百分比
m_bChangeJudgeOpt连续聚焦模式下,判断场景变化的条件:0:FV或luma满足其一 1:FV与luma均满足
m_nChangeFrameNum连续聚焦模式下,判断场景变化的帧数
m_nChangeStatAreaPercentage连续聚焦模式下,判断场景变化的AF统计窗口面积改变门限百分比,超出此门限认为场景发生改变,人脸模式有效
m_nChangeStatCenterPercentage连续聚焦模式下,判断场景变化的AF统计窗口位置改变门限百分比,超出此门限认为场景发生改变,人脸模式有效
m_pChangeExpIndexPercentage连续聚焦模式下,判断场景变化的曝光量变化百分比
m_pChangeFVSADPercentage在连续聚焦模式下,判定当前帧变化的FV的SAD百分比
m_pChangeLumaSADThr在连续聚焦模式下,判定当前帧变化的亮度的SAD百分比
m_pChangePDShiftThr在连续聚焦模式下,判定当前帧变化的PDShift的百分比

前景追踪模式

参数名说明建议调试特殊性
m_bForeGroundTrackInCoarse粗步长调节时前景追踪模式使能:0:不使能前景追踪 1:使能前景追踪用户设置
m_bForeGroundTrackInFine细步长调节时前景追踪模式使能:0:不使能前景追踪 1:使能前景追踪用户设置
m_nForeGroundTrackWindow前景追踪窗口:3:3x3 4:4x4 5:5x5用户设置
m_bForeGroundTrack前景追踪模式使能:0:不使能前景追踪 1:使能前景追踪用户设置
m_pFVBlkDropPercentage前景追踪模式使能下的FV值下降的判定百分比
m_pFVBlkIncreasePercentage前景追踪模式使能下的FV值上升的判定百分比
m_pFineStepStartPosSelectConf前景追踪模式使能下,开始走细步长时的起始位置的置信度阈值
m_pFineStepEndPosSelectConf前景追踪模式使能下,细步长走完后最终位置的置信度阈值

AF frameinfo

参数名说明建议调试特殊性
m_nGain当前系统增益,Q4 format-只读
m_nPDShiftPD偏移-只读
m_nPDConfPD置信度-只读
m_nCurrentPosition当前电机位置-只读
m_nFSMStatusAF状态机-只读
m_nFocusStatFlag聚焦状态标志0:初始 1:成功 2:失败-只读
m_nFocusFrameCost一次单次聚焦完成所花费的帧数-只读
m_nMotorMoveStep实时电机步长-只读
m_bCoarseFineStepFlag实时处于粗/细步长标志0:当前处于细步长 1:当前处于粗步长-只读
m_nMotorMoveSkipFrameNum电机每次移动跳过的帧数-只读
m_bStartFromMinFlag实时电机运动方向0:从最大电机位置到最小电机位置 1:从最小电机位置到最大电机位置-只读
m_bStartFromCurrentFlag电机初始从当前位置开始运动的标志0:从预运动位置出发 1:从初始位置出发-只读
m_bSoftwareMotorCtrlFlag从当前位置向目标位置运动过程中受到软件控制改变的标志-只读
m_nPositionScanNum电机扫描过的方向计数-只读
m_nPositionAdjustNum电机走过的位置计数-只读
m_pRTFVList实时FV值-只读
m_pMinFVList单次聚焦过程中的最小FV值-只读
m_pMaxFVList单次聚焦过程中的最大FV值-只读
m_pMaxFVPositionList单次聚焦城中的最大FV值所在的位置-只读
m_pFVUnchangeFlagFV曲线过于平滑而失效的标志0:FV曲线可信 1:FV曲线失效-只读
m_pFailCondition判定本地聚焦失败的三个条件的状态0:当前条件判定聚焦成功 1:当前条件判定聚焦失败-只读
m_pFSMPosSingleFocus单次聚焦过程中,帧号-电机位置-状态机信息记录-只读
m_pPosFvSingleFocus单次聚焦过程中,帧号-6种类型FV值信息记录-只读
m_pRefFV连续聚焦模式下,记录的FV参考值-只读
m_pSeqFV连续聚焦模式下,实时FV值序列-只读
m_pRefLumaR连续聚焦模式下,记录的R通道缩略图参考值-只读
m_pRefLumaG连续聚焦模式下,记录的G通道缩略图参考值-只读
m_pRefLumaB连续聚焦模式下,记录的B通道缩略图参考值-只读
m_pSeqLumaR连续聚焦模式下,实时R通道缩略图-只读
m_pSeqLumaG连续聚焦模式下,实时G通道缩略图-只读
m_pSeqLumaB连续聚焦模式下,实时B通道缩略图-只读
m_nRefExpIndex连续聚焦模式下,参考曝光index-只读
m_nRTExpIndex连续聚焦模式下,实时曝光index-只读
m_bPDInfoDisable连续聚焦模式下,使用PD信息标志位-只读
m_nLumaAverage亮度均值-只读
m_nSceneVariance缩略图实时方差-只读
m_bSceneFlatFlag场景平坦标志位-只读
m_nChangeExpIndex连续聚焦模式下,当前曝光index与参考曝光index的差-只读
m_nChangeExpIndexThr连续聚焦模式下,判断场景变化的曝光index门限-只读
m_nChangeFVSAD连续聚焦模式下,实时FV与参考FV之间的SAD差-只读
m_nChangeFVSADThr连续聚焦模式下,判断场景变化的SAD门限-只读
m_nChangeLumaSAD连续聚焦模式下,实时亮度 SAD值-只读
m_nChangeLumaSADThr连续聚焦模式下,实时亮度 SAD门限-只读
m_nRefocusLumaSADCAF触发SAF时,前帧亮度SAD-只读
m_nRefocusLumaSADThrCAF触发SAF时,决定是否触发的SAD门限-只读
m_bStableExpIndexFlagAE曝光表稳定标志位-只读
m_bStableFVFlagFV稳定标志位-只读
m_bStableAFLumaFlagAFM luma稳定标志位-只读
m_bStableAELumaFlagAEM luma稳定标志位-只读
m_bPDTriggerCAFPD触发AF标志位-只读
m_bFVTriggerCAFFV触发AF标志位-只读
m_bLumaTriggerCAFLuma触发AF标志位-只读
m_bExpIndexTriggerCAFExpIndex触发AF标志位-只读
m_bRefocusTriggerCAFCFA触发SAF标志位-只读

CAWBFilter 参数说明

CAWBFilter(AWB)模块用于自动白平衡控制。

灰度世界

参数名说明建议调试特殊性
m_bGrayWorldEn灰度世界模式使能:0:关闭灰度世界1:使能灰度世界,此时由灰度世界算法计算白平衡增益用户设置

ROI 控制

参数名说明建议调试特殊性
m_pRoiBound16个ROI区域控制
m_pRoiLumLutHigh统计块亮度上限
m_pRoiLumLutLow统计块亮度下限
m_pRoiEnROI使能
m_pRoiWeightLut不同亮度索引对应的权重
m_pRoiLumThre亮度lux索引门限
m_bRoiLimitManual固定ROI使能:0:依据自动白点ROI及低色温统计块占比计算白点限制区域 1:白点限制区域固定为RoiCtHigh,RoiCtLow,RoiXMax,RoiXMin
m_nRoiCtHigh白点ROI 纵坐标Y上限,在ROI区域以外的block计算白平衡时权重为0(CT(color temperature)为BlockBlue_sum(8bit) / BlockRed_sum * 1024)
m_nRoiCtLow白点ROI 纵坐标Y下限
m_nRoiXMax白点ROI 横坐标X上限(X为BlockBlue_sum BlockRed_sum / BlockGreen_sum / BlockGreen_sum 1024)
m_nRoiXMin白点ROI 横坐标X下限
m_pRoiCtHighAuto不同亮度下白点ROI 纵坐标Y上限
m_nRoiCtLowAuto不同亮度下自动白点ROI 纵坐标Y下限
m_nRoiXMaxAuto不同亮度下自动白点ROI 横坐标X上限
m_nRoiXMinAuto不同亮度下自动白点ROI 横坐标X下限
m_nValidNum每个ROI生效的最小块数,处于统计亮度区间的块的数目小于该值时,该ROI不参与白平衡计算
m_bWeightOnSumBlock权重计算方式:0:以block的和计算 1:以block的rgb gain计算

白平衡 Gain 控制

参数名说明建议调试特殊性
m_pAWBGainLimit最终WB gain限制区域
m_nAWBCTShiftWB Gain向上偏移距离,用于将低色温场景往暖色调偏移
m_pAWBCTShiftThrWB Gain偏移Y门限:Y<AWBCTShiftThr[0]时WB Gain向上偏移m_nAWBCTShift,Y>AWBCTShiftThr[1]时WB Gain不偏移,中间为插值区域

混光场景降高色温权重

参数名说明建议调试特殊性
m_sRoiBoundDayLight高低色温混合场景,高色温统计块框选区域,落入该区域的统计块为高色温统计块
m_pLowCtNumThr低色温统计块所占千分比门限,(见图示lowCtLightPermillage-ratio)低色温统计块所占千分比>LowCtNumThr[0]时,高色温统计块权重开始降低;低色温统计块所占千分比≥LowCtNumThr[1]时,高色温统计块权重降到最低。
m_pDayLightNumThr高色温统计块所占千分比门限,(见图示dayLightPermillage-ratio)高色温统计块所占千分比<DayLightNumThr[1]时, 高色温统计块权重开始降低;高色温统计块所占千分比≤DayLightNumThr[0]时,高色温统计块权重不再降低,与m_pLowCtNumThr共同作用决定高色温统计块权重降低的基础强度baseRatio。
m_pLowCtThr高低色温混合场景,降高色温统计块权重的Y门限(见图示CtThr – ProtectRatio )Y<m_pLowCtThr[1]的统计块为低色温统计块
m_pLowCtProtectRatio降高色温统计块权重系数,值越小,高色温统计块权重越低,与baseRatio共同决定统计块的权重(见图示CtThr – ProtectRatio )随CtThr变化
m_nLog2CwtOverACWF与A光权重比

CtThr – ProtectRatio 示意图

lowCtLightPermillage-ratio 示意图

dayLightPermillage-ratio 示意图

绿区控制

参数名说明建议调试特殊性
m_pRoiBoundG绿区ROI控制
m_pRoiLumLutHighG绿区统计块亮度上限
m_pRoiLumLutLowG绿区统计块亮度下限
m_bGreenShiftEn绿区ROI使能用户设置
m_pGreenLumThre绿区不同亮度索引下的权重表
m_nGreenShiftMax绿区权重上限:与exposure shift相乘得到最终的shift权重,最大32,完全偏向outdoor gain
m_pGreenNumThre绿区统计块门限, 落在绿区的统计块的数目在此区间则进入green shift
m_pOutdoorGain绿区白平衡目标增益

AWB frameinfo

参数名说明建议调试特殊性
m_bAwbCalStatusAWB计算状态-只读
CurrentResult当前应用白平衡增益-只读
CurrentTargetAWB计算得到的目标白平衡增益-只读
m_nSceneLuxAWB debug参数,当前AE计算得到的场景照度-只读
m_nValidBlkNum有效统计块数-只读
m_nLowCtBlkRatio低色温统计块占千分比-只读
m_pCtLimit当前ROI范围(X_Max,X_Min,CT_High,CT_Low)-只读
m_nDayLightBlkRatioD光统计块占千分比-只读
m_nGreenShiftWeight绿区偏移权重-只读
m_pStatBlkRR通道统计值-只读
m_pStatBlkGG通道统计值-只读
m_pStatBlkBB通道统计值-只读
m_pBlkCtX统计块横坐标X-只读
m_pBlkCtY统计块纵坐标Y-只读
m_pBlkRoiId统计块所处ROI-只读
m_pBlkWeight统计块参与白平衡计算的权重-只读
m_pDebugBlcokData[23][31]AWB统计块的RGB值-只读

C3DNRFirmwareFilter 调试说明

C3DNRFirmwareFilter(NR)模块用于 2D 与 3D 去噪。

NR 使能

参数名说明建议修改特殊性
m_nTnrEb3DNR使能,仅用于控制3DNR用户设置
m_pTnr3dYEb3DNR 亮度去噪开关可随Gain/Layer变化
m_pTnr3dUVEb3DNR 颜色去噪开关可随Gain/Layer变化
m_pTnr2dYEb2DNR 亮度去噪开关可随Gain/Layer变化

2D NR 基础控制参数

参数名说明建议修改特殊性
m_pMax_diff_thr最大亮度参考门限,Dynamic使能时有效
m_pSig_gain亮度参考门限,值越小,越多区域被去噪可随Gain/Layer变化
m_pAback_alpha亮度噪声回加,值越大,回加的亮度噪声的越多可随Gain/Layer变化
m_pCnrSig_yCNR参考Y门限,值越大,越多区域被去噪可随Gain/Layer变化
m_pCnrSig_uvCNR参考UV门限,值越大,越多区域被去噪可随Gain/Layer变化
m_pCnrAback_alpha颜色噪声回加,值越大,回加的颜色噪声的越多可随Gain/Layer变化
m_pCnrSig_uv_shiftCNR门限左移系数,(1表示门限左移一位,即乘2)可随Gain/Layer变化
m_pGainIndex增益索引,建议保持缺省值
m_bDynamic_en去噪门限自适应使能,打开时亮度去噪门限的ratio依据图像内容动态计算
m_nGlobalYnrStrength全局亮度噪声去噪强度可随Gain/Layer变化
m_nGlobalCnrStrength全局颜色噪声去噪强度可随Gain/Layer变化

部分参数可随 Gain/Layer 调整,以 m_pCnrSig_y 为例:

Column 表示 Gain 的档位,Column[0]表示 1 倍 gain;Column[11]表示 2048 倍 gain; Row 表示不同 layer 的参数,Row[0]表示 layer 0 的参数;Row[4]表示 layer 4 的参数;

(layer 越高,对应处理图像越高频的区域)

2D NR 亮度控制参数

参数名说明建议修改特殊性
m_bLuma_enYNR随亮度变化使能用户设置
m_pLuma_sig随亮度变化, 2D YNR强度,level 0-16 对应亮度0-255, 16等分可随Gain/Luma变化
m_bCnrLuma_enCNR强度随亮度控制使能用户设置
m_pCnrLuma_sig随亮度变化, 2D CNR强度,level 0-16 对应亮度0-255, 16等分可随Gain/Luma变化

2D NR 沿半径调节去噪强度

参数名说明建议修改特殊性
m_bRadial_en去噪强度沿半径调节使能:0 : 关闭 1: 使能用户设置
m_pRadial_ratio去噪强度随沿半径增强强度控制,值越大,边缘去噪强度越强可随Gain/Layer变化
m_bCnrRadial_en去彩噪强度沿半径调节使能:0 : 关闭 1: 使能用户设置
m_pCnrRadial_ratio去彩噪强度随沿半径增强强度控制,值越大,边缘去彩噪强度越强可随Gain/Layer变化

3D NR 运动区域检测及去噪强度控制

参数名说明建议修改特殊性
m_pTnrDAvg帧间亮度平均差门限,值越小,越容易判断为运动可随Gain/Layer变化
m_pTnrWAvg帧间亮度平均差权重,值越大,依据亮度帧间平均差检测运动的权重越大可随Gain/Layer变化
m_pTnrQWeightAvg帧间亮度平均差系数,值越大,越容易判断为运动可随Gain/Layer变化
m_pTnrDSad帧间亮度绝对差和门限,值越小,越容易判断为运动可随Gain/Layer变化
m_pTnrWSad帧间亮度绝对差和权重,值越大,依据帧间亮度绝对差和检测运动的权重越大可随Gain/Layer变化
m_pTnrQWeightSad帧间亮度绝对差和系数,值越大,越容易判断为运动可随Gain/Layer变化
m_pTnrDuv帧间UV平均差门限,值越小,越容易判断为运动可随Gain/Layer变化
m_pTnrWuv帧间UV平均差权重,值越大,依据UV帧间平均差检测运动的权重越大可随Gain/Layer变化
m_pTnrQWeightUV帧间UV平均差,值越大,越容易判断为运动可随Gain/Layer变化
m_nTnrLumaBase基准亮度差阈值,值越小,越容易判断为运动
m_pTnrLuma依据亮度控制帧间亮度平均差门限,值越小,越容易判断为运动可随Gain/Layer变化
m_pTnrYStrengthQ6Tnr亮度去噪全局强度,值越大,静止区域亮度去噪强度越大可随Gain/Layer变化
m_pTnrUVStrengthQ6Tnr颜色去噪全局强度,值越大,静止区域颜色去噪强度越大可随Gain/Layer变化
m_pStrongSig_gain运动区域亮度去噪参考门限,值越小,越多区域被去噪可随Gain/Layer变化
m_pStrongAback_alpha运动区域亮度噪声回加,值越大,回加噪声越多可随Gain/Layer变化

3D NR 其他参数参数

参数名说明建议修改特殊性
m_nTnrLumaWeight计算luma的窗口大小
m_pTnrBlockWeight0Layer0计算亮度差的窗口大小
m_pTnrBlockWeight1Layer1计算亮度差的窗口大小
m_pTnrBlockWeight234Layer2,3,4计算亮度差的窗口大小
m_pTnr2dMappingCurve运动区域不同亮度去噪强度融合系数,值为256全用weak(静止区域)去噪强度,值为0时strong(运动区域)权重最大
m_p*RatioReserved
彩边抑制

彩边抑制功能由过曝点和 hue_pf 区间共同控制,满足过曝点且落入 hue_pf 区间的色边将被抑制。

参数名说明建议修改特殊性
eb颜色检测开关,开启时对肤色和蓝天区域的去噪会加强用户设置
m_ppf_en紫边去除使能:0 : 关闭 1: 使能用户设置
m_nwp_en紫边去除过曝区域检测使能:0 : 关闭 1: 使能用户设置
m_nwp_th过曝像素判定门限,值越大,越少像素被判定为过曝点(见Uv_wp_gain- num_wb示意图)
m_nnum_wp_min过曝区域作用起始阈值,过曝点数目大于该阈值时,紫边去除开始起作用(见Uv_wp_gain- num_wb示意图)
m_nnum_wp_step过渡区间控制,(见Uv_wp_gain- num_wb示意图)
m_nhue_pf_min紫边hue区间下限(见Uv_pf_gain- hue_pf示意图)
m_nhue_pf_max紫边hue区间上限(见Uv_pf_gain- hue_pf示意图)
m_nhue_pf_tr_step紫边hue过渡区间控制,(见Uv_pf_gain- hue_pf示意图)
m_nuv_wp_gain过曝点的权重,值越大,过曝点对最终饱和度的影响越大(见Uv_wp_gain- num_wb示意图)可随Gain变化
m_nuv_pf_gain紫边区间的权重,值越大,紫边区间对最终饱和度的影响越大(见Uv_pf_gain- hue_pf示意图)可随Gain变化

Uv_pf_gain – hue_pf 示意图

Uv_wb_gain – num_wp 示意图

Raw HDR 参数说明

Raw_HDR_Soft 模块用于控制软件 HDR。

Raw HDR 参数

参数名说明建议调试特殊性
m_nHDRDownSampleEb降采样使能,输入图像宽或高大于8225时需打开
m_nINTFlag错误处理标志位
m_pGTMCurveSetGTM曲线,5组对应长短曝光倍数1,4,16,64,256

File to File

File to File 功能说明

平台支持硬件仿真,即 File to File(f2f),将 VRF 文件推送到设备中,替换 sensor 图像数据,得到 ISP 处理之后的图像,适用于单帧仿真。

File to File 使用说明

  1. 通过 USB 将设备与 PC 相连;
  2. 通过 ADB 将 VRF 文件 push 到指定路径,指定文件名(不同文件名对应不同 tuning 参数); 主摄 adb push xxx.vrf vendor/etc/camera/rear_primary_sensor.vrf 副摄 adb push xxx.vrf vendor/etc/camera/rear_secondary_sensor.vrf 前摄 adb push xxx.vrf vendor/etc/camera/front_sensor.vrf
  3. 启动 camera,即可看到经过 ISP 处理的 VRF 预览效果,也可拍摄为 JPG;

Tuning 参数快速验证

Tuning 参数快速验证功能说明

  1. 平台支持 tuning 参数快速验证功能,打开如下 property
adb shell setprop persist.vendor.camera.enable.settingfile 1
  1. 从 Tuning Tool 中保存 tuning 参数,并通过 ADB push 到设备指定路径,指定文件名,重启相机即可生效。 adb push xx.data /vendor/etc/camera/tuning_files/

路径:

/vendor/etc/camera/tuning_files/

文件名:

FlickerSetting.data
front_cpp_nightshot_setting.data // 前摄
front_cpp_preview_setting.data front_cpp_snapshot_setting.data front_cpp_video_setting.data front_isp_setting.data front_isp_setting_video.data front_nightshot_setting.data rawhdr_default_setting.data rear_primary_cpp_nightshot_setting.data // 主摄
rear_primary_cpp_preview_setting.data rear_primary_cpp_snapshot_setting.data rear_primary_cpp_video_setting.data rear_primary_isp_setting.data rear_primary_isp_setting_video.data rear_primary_nightshot_setting.data
rear_secondary_cpp_nightshot_setting.data // 副摄
rear_secondary_cpp_preview_setting.data rear_secondary_cpp_snapshot_setting.data rear_secondary_cpp_video_setting.data rear_secondary_isp_setting.data rear_secondary_isp_setting_video.data rear_secondary_nightshot_setting.data

VRF viewer

VRF viewer 界面

单击 VRF ,启动 VRF viewer,界面如下

Figure - VRF viewer

  • menu:菜单功能区

    • Open:打开图像(支持*.vrf, *.nv12, *.nv21, *.yuv, *.bmp, *.jpg, *.jpeg, *.png)
    • Save:保存图像(*.bmp, *.jpg, *.jpeg, *.png)
    • Options:图像处理选择项(单击 Apply 应用 option,单击 Save 保持当前 options)针对 VRF 图像的处理选项:
      • Demosaic :去马赛克
      • Linearization :线性化
      • WB :应用 vrf 中白平衡增益
      • Dgain : 应用 vrf 中数字增益
      • Gamma : 应用 sRGB 曲线
      • Split Channel:分别显示 bayer 四个通道针对 YUV 图像的处理选项:
      • 色彩标准 :BBT601 / BT709
      • swing:yuv 数据范围
      • YUV :nv12 / nv21 转换
      • Gray Image : 灰度图
  • ZoomIn:图像放大

  • Normal:图像原始大小

  • ZoomOut:图像缩小

  • Move:拖动图像

  • Select:框选图像

  • Histogram:直方图信息

  • Info:显示 vrf 信息

  • Window:选择打开的图像

  • Previous:显示前一张图像

  • Next:显示后一张图像