ISP PQ Tool User Guide

简介

概述

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

缩略语

Name	Description
ISP	Image Signal Process
VRF / vrf	RAW image with information at the end
BLC	Black Level Correction
LSC	Lens Shading Correction
AWB	Auto White Balance
AEC	Auto Exposure Control
AF	Auto Focus
OTP	One Time Programmable
AEM	Auto Exposure Monitor
AFM	Auto Focus Monitor
CCM	Color Correction Matrix
CT	Color Temperature
BPC	Bad Pixel Correction
CAC	Color Aberration Correction
LTM	Local Tone Mapping
PDC	Phase Detection Compensation
PDF	Phase Detection Correction
PDAF	Phase Detection Auto Focus
SE	Special Effect
EIS	Electronic Image Stabilization
CDAF	Contrast Detection Auto Focus
FV	Focus Value
SAD	Sum of absolute difference
ROI	Region of Interest
NR	Noise Reduction
EE	Edge Enhancement
HDR	High Dynamic Range
Qn	Accuracy, 2n is double

Tuning Tool 概述

Tuning Tool 框架

Figure - ISP Tool 框架

PC 端 tuning tool 安装

调试软件是免安装的压缩文件，解压即可使用，文件名 AsrIspToolVX.X.X.X.rar

解压后包含如下文件：

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
特别说明
- 在插件或参数列表中修改参数，会标红显示修改的内容，鼠标覆盖时会显示原值。

实时修改参数

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

抓取 VRF 图

在菜单功能区点击 Capture 按钮
选择 RAW，设置保存路径
点击 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 批量读

保存参数

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

打开本地参数文件

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

Offline 基本操作

打开本地参数文件

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

修改参数

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

定标插件

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

保存参数

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

ISP 插件

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

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

BLC 定标与调试

BLC 定标 VRF 图要求

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

BLC 定标步骤

Figure - BLC 定标界面

在 BLC 插件中点击 Load 导入 VRF 图；
选择 Pipe ID（非单 pipeline 可选）；
选择 Channel ID；
点击 Calibrate，校正结果显示在 Calibrated Result 界面，若结果不理想亦可手动修改 Result；
点击 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 定标界面

在 LSC 插件中点击 Load 导入 VRF 图；
选择 Pipe ID（非单 pipeline 可选）；
选择 Channel ID；
调整补偿的比例 Current Percentage，建议先设为 100%，后期可修改 strength 控制补偿强度；
点击 Calibrate，校正仿真结果显示在 Calibrated Image；
点击 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 定标界面

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

CCT 定标步骤

Figure - CCM 定标界面

定标步骤与 CCM 定标可同时进行, CCT 只需要 A 与 D65；
CCM Calibrate A 光之后，选择 profile 2850K，点击 UpdateCTMatrix；
CCM Calibrate D65 光之后，选择 profile 6500K，点击 UpdateCTMatrix；
结果将自动更新到 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 定标界面

打开 AWB 插件。
点击 Optimize，定标参数将自动更新到参数界面；

AWB 亮度定标

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

相机置于灯箱,拍摄灯箱壁,光源选择 D65；
使用色温照度计测量灯箱照度，填入 AECFilter 中 m_nCalibSceneLux；
在 AECFilter 中读取 m_nExpIndexLong，填入 AECFilter 中 m_nCalibExposureIndex；
在 AECFilter 中读取 m_nLumQ16，填入 AECFilter 中 m_nCalibSceneLum；

参数名	说明	建议调试	特殊性
m_nCalibExposureIndex	亮度定标的曝光索引	是
m_nCalibSceneLum	亮度定标的场景亮度	是
m_nCalibSceneLux	定标场景对应的实际照度	是
m_nSceneLux	AWB 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 调试界面

打开 Curve 插件;
选择 Pipe ID（非单 pipeline 可选）；
选择 Channel ID；
鼠标滑至 Curve 上想要调节的点，左键拖动到期望位置；
点击 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 定标界面

在 Noise 插件中点击 Load 导入 RAW 图，VRF 使用 Raw preprocessor 插件补偿 LSC 和 PDF(如存在 PD 像素)；
在图中框选色卡最下方的 6 个块，保证 6 个 ROI 都落在色块之内，若拍摄图片不正或畸变严重，可点击 sta rt，勾选期望单独调整的 ROI,然后手动拖动 ROI；
设定期望 Denois Strength；
点击 Calibrate，标定噪声水平显示在 Noise Result；
选择 Pipe ID；
选择 Channel ID；
点击 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 定标界面

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

PDC 定标

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

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

PDC 定标 VRF 图要求

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

PDC 定标步骤

Figure - PDC 定标界面

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

PDC 定标说明

m_pPixelMask，m_pPixelTypeMask 说明

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

Raw preprocessor 插件

Raw preprocessor 插件说明

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

Raw preprocessor 插件使用

Figure - Raw preprocessor 界面

在 Raw preprocessor 插件中设置 input 和 output VRF 文件；
选择对应的 pipe 以及 LSC channel；
选择期望的预处理功能，PDF，LSC，Unpack；
点击 Preprocess
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_nBayerPattern	Bayer模式:0: RGGB 1: GRBG 2: GBRG 3: BGGR 4: monochrome	依据硬件设置
m_bAELinkZoom	AE窗口关联zoom	用户设置
m_bAFLinkZoom	AF关联zoom	用户设置
m_bAWBLinkZoom	AWB关联zoom	用户设置
m_nPreviewZoomRatio	预览zoom系数，Q8	用户设置
m_bPreviewLowPowerMode	预览低功耗模式	用户设置
m_nAEProcessPosition	AE处理时机0: eof 1: sof	用户设置
m_nAEProcessFrameNum	AE处理频率，支持：eof每帧处理 / eof 每两帧处理 / sof每帧处理 / sof 每三帧处理	用户设置
m_bHighQualityPreviewZoomEnable	Reserved

CAEMFirmwareFilter 参数说明

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

AEM 使能及参数

参数名	说明	建议调试	特殊性
m_bEnable	AEM使能：0：关闭自动曝光统计模块 1：使能自动曝光统计模块	否
m_nAEStatMode	AE统计模块模式：0：统计信息不经过白平衡 1：统计信息经过白平衡	否
m_bZSLHDRCapture	零延迟HDR抓拍使能0：不启动 1：启动零延迟HDR抓拍功能	用户设置
m_nInitialExpTime	初始化曝光时间	是
m_nInitialAnaGain	初始化模拟增益	是
m_nInitialSnsTotalGain	初始化sensor总增益	是
m_nInitialTotalGain	初始化总增益	是
m_nStableTolerance	AE稳定容忍度百分比：若当前曝光量与前一次曝光量的差值小于前一次曝光量的m_nStableTolerance%，则给出AE StableFlag信号，供其他模块如LTM参考	用户设置
m_nStableToleranceExternal	AE稳定容忍度百分比，共外部系统使用	用户设置
m_bAutoCalculateAEMWindow	AE统计窗口计算方式：0：由hardware配置 1：由firmware控制	否
m_nPreEndingPercentage	不参与AE统计模块的行数相对于图像高的百分比	否
m_bDRCGainSyncOption	DRCgain同步：0：每帧同步 1：AE稳定后同步	否
m_pSceneChangeSADThr	判断场景变化的SAD门限	用户设置
m_pSubROIPermil	6个子统计模块的起始坐标及结束坐标相对于图像宽高的千分比可根据人脸测光或对焦测光联动，由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_bEnable	digital gain使能：0：关闭数字gain 1：使能数字gain	用户设置
m_nISPGlobalOffsetValue12bit	0：在stretch中扣除黑电平1：在digital gain中完全扣除黑电平2-511：完全扣除黑电平后,12bit添加的offset（此offset会在stretch扣除）	用户设置
m_bManualMode	手动模式使能 0: 自动模式1: 打开手动模式，此时黑电平参数不随gain变化，使用manual参数，用于debug
m_pGlobalBlackValueManual	手动模式参数，作用和自动一致
m_pGlobalBlackValueManualCapture	同上，拍照起效
m_pGlobalBlackValue	R/ GR/ GB/ B四个通道的黑电平（见Gain-BlackValue示意图）	定标结果参数	可随gain变化
m_pGlobalBlackValueCapture	同上，拍照起效	定标结果参数	可随gain变化
m_pWBGoldenSignature	白平衡golden模组特征	-	只读
m_pWBCurrentSignature	白平衡当前模组特征	-	只读

Gain – BlackValue 示意图

CWBGainFirmwareFilter 参数说明

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

WBGain 使能

参数名	说明	建议调试	特殊性
m_bEnable	WB gain使能：0：关闭白平衡gain 1：使能白平衡gain	否

CStretchFirmwareFilter 参数说明

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

Stretch 使能

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

CColorMatrixFirmwareFilter 参数说明

CColorMatrixFirmwareFilter（CCM）模块用于色彩校正。

CCM 使能

参数名	说明	建议调试	特殊性
m_bEnable	CMC使能：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_nHueTransShiftNum	Hue过渡带偏移系数:（示例见图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_bEnable	BPC使能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_pSlopeG	G通道控制曲线参数，值越大，容忍度越大，去坏点能力越弱	是	可随Gain和Lum变化
m_pInterceptG	G通道控制曲线参数，值越大，容忍度越大，去坏点能力越弱	是	可随Gain和Lum变化
m_pSlopeRB	RB通道控制曲线参数，值越大，容忍度越大，去坏点能力越弱	是	可随Gain和Lum变化
m_pInterceptRB	RB通道控制曲线参数，值越大，容忍度越大，去坏点能力越弱	是	可随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_nDeadRatioG	G通道暗点系数，值越大，G通道暗点容忍度越大，去坏点能力越弱	是
m_nDeadRatioRB	RB通道暗点系数，值越大，RB通道暗点容忍度越大，去坏点能力越弱	数
m_bSpikeEnable	亮点矫正使能	用户设置
m_nSpikeRatioG	G通道亮点系数，值越大，G通道亮点容忍度越大，去坏点能力越弱	是
m_nSpikeRatioRB	RB通道亮点系数，值越大，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_bGrGbNum	GrGb通道预矫正使能1：打开GrGb通道预矫正，开启后可排除GrGb通道坏点干扰	用户设置
m_bAroundDetEn	亮块检测使能使能可保护亮度突变的像素块	用户设置
m_bBlockDetEn	2x2 坏块检测使能使能可排除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_bEnable	LSC使能0: 关闭镜头阴影校正 1: 打开镜头阴影校正	用户设置
m_bUseOTP	LSC OTP使能	用户设置

LSC 参数

参数名	说明	建议调试	特殊性
m_bAutoScale	AutoScale使能：0: 关闭自动计算缩放参数功能 1: 打开自动计算缩放参数功能	否
m_bEnhanceEnable	Enhance使能：当前模组期望补偿倍数超过4倍时需要打开0: 关闭shading增强功能 1: 打开shading增强功能	用户设置
m_nProfileSelectOption	shading补偿表选择：0：依据色温自动选择 1：使用LSC Profile[0] 2：使用LSC Profile[2] 3：使用LSC Profile[2]	否
m_nFOVCropRatioH	水平方向裁剪比例	是	binning尺寸决定
m_nFOVCropRatioV	垂直方向裁剪比例	是	binning尺寸决定
m_pLSCStrength	shading补偿强度：（示例见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_pLSCProfile	LSC补偿表，由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_nGradMaxError	CSC估计统计值梯度与真实统计值梯度最大误差容忍值	是
m_nGradThrConv	CSC两次计算的梯度差异门限，梯度差异小于该值，不更新CSC	是
m_nGradMax	CSC最大补偿强度	是
m_nTblAlpha	收敛速度，值越大收敛越快	是
m_nCSCGlobalStrength	CSC全局强度	是
m_nEffPNumAll	全图像有效块门限	否
m_nEffPNumHalf	1/2图像有效块门限	否
m_nEffPNumQuarter	1/4图像有效块门限	否
m_pEffNumRing	三个ROI对应的有效块门限，ROI0为中心6x4，ROI1为中心12x8(不包含ROI0)，ROI2为12x12（不包含ROI0,ROI1）	否
m_pCSCCTIndex	CSC色温控制点，CT > CSCCTIndex[1]时CSC失效	是
m_pCSCLuxIndex	CSC亮度控制点，Lux > CSCLuxIndex[1]时CSC失效	是

LSC Manual 及 frameinfo

参数名	说明	特殊性
m_bManualMode	手动模式使能：1: 打开手动模式，此时LSC参数不随色温变化，使用manual参数，用于debug	Debug参数
m_nLSCStrengthManual	手动模式参数, 具体功能和自动功能一致	Debug参数
m_pLSCProfileManual	手动模式参数, 具体功能和自动功能一致	Debug参数
m_nRGPolyCoefRO	当前CSC补偿R ratio	只读
m_nBGPolyCoefRO	当前CSC补偿B ratio	只读
m_pRGRatio	16x12 统计块对应R/G ratio	只读
m_pBGRatio	16x12 统计块对应B/G ratio	只读
m_pOTPProfileInternal	OTP shading表	只读

CDemosaicFirmwareFilter 调试说明

CDemosaicFirmwareFilter（Demosaic）模块用于 Bayer 插值。

Demosaic 子功能使能

参数名	说明	建议调试
m_bIfEdgeGenerate	高频信息生成功能开关:可用于inline sharpen(inline sharpen功能需要cmc模块配合使用) 0：关闭 1：打开	用户设置
m_bIfGbGrRebalance	GbGr差异消除功能开关0：关闭 1：打开	否
m_bIfDNS	inline 去噪功能开关, 建议关闭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_nGbGrThr	GbGr差异消除功能对应的阈值,越小GbGr差异消除功能越弱, 反之则越强	是	可随Gain变化
m_nSharpenStrength	高频信息放大倍率，值越大，锐化越强	是	可随Gain变化
m_nShpThreshold	高频信息软阈值处理时的阈值, 建议保持缺省值	否	可随Gain变化
m_nDenoiseThreshold	inline 去噪功能软阈值, 越大去噪能力越强, 建议保持缺省值	否	可随Gain变化
m_nNoiseAddbackLevel	inline 去噪功能噪声回加强度, 越大去噪能力越弱, 建议保持缺省值	否	可随Gain变化
m_pDenoiseLumaStrength	依据亮度控制去噪强度缩放系数，亮度区间为8bit下[8，16，32]，亮度64以上系数为32，不缩放	否	可随Gain变化
m_nChromaNoiseThreshold	去除彩噪功能阈值, 越大去除彩噪能力越强, 建议保持缺省值	否	可随Gain变化
m_pUSMFilter	USMFilter = 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_bEnable	RAW 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_pGns	G通道去噪强度, 值越大去噪强度越强	是	可随Gain变化
m_pRbns	RB通道去噪强度, 值越大去噪强度越强	是	可随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_bEnable	AFM使能0: 关闭自动对焦统计模块 1: 打开自动对焦统计模块	用户设置

AFM 参数

参数名	说明	建议调试	特殊性
m_nAFStatMode	AF统计模块模式：0：经过白平衡 1：不经过白平衡	否
m_nWinStartXPermil	AFM水平方向起始点坐标千分比	用户设置
m_nWinStartYPermil	AFM垂直方向起始点坐标千分比	用户设置
m_nWinEndXPermil	AFM水平方向结束点坐标千分比	用户设置
m_nWinEndYPermil	AFM垂直方向结束点坐标千分比	用户设置
m_nMinWidthPermil	AFM最小宽度千分比	用户设置
m_nMinHeightPermil	AFM最小高度千分比	用户设置
m_bConfigDone	FW控制参数，AF窗口设置完成时设1	否
m_pFVList	各对焦窗口Focus value值	-	只读
m_nFVAvg	Focus value平均值	-	只读
m_nWinStartX	AFM水平方向起始点坐标	-	只读
m_nWinStartY	AFM垂直方向起始点坐标	-	只读
m_nWinWidth	AFM宽度	-	只读
m_nWinHeight	AFM高度	-	只读

CPDCFirmwareFilter 参数说明

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

PDC 使能

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

PDC 参数

参数名	说明	建议调试	特殊性
m_bOut	PD 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_nFullWidth	sensor输出图像宽度	是
m_nFullHeight	sensor输出图像高度	是
m_nWindowMode	窗口模式：0: 自动计算PD dump区域；1: 通过m_nWinStartXPermil,m_nWinStartYPermil, m_nWinEndXPermil 和EndYPermil计算PD dump区域；	否
m_nWindowScaleFactor	PDC统计窗相对于AFM统计窗的缩放比例	用户设置
m_nMinWidthPermil	PDC统计窗最小宽度千分比	用户设置
m_nMinHeightPermil	PDC统计窗最小高度千分比	用户设置
m_pPDFirstX	水平方向PD区域相对于sensor输出图像宽度的偏移量（见窗口示意图）	是
m_pPDFirstY	垂直方向PD区域相对于sensor输出图像高度的偏移量（见窗口示意图）	是
m_pRatioA	四通道全局调节比例	是
m_pPixelMask	32x32的区域内PD点的分布	是
m_pPixelTypeMask	32x32的区域内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_nWinStartX	PDC统计窗水平方向起始点坐标	-	只读
m_nWinStartY	PDC统计窗垂直方向起始点坐标	-	只读
m_nWinWidth	PDC统计窗宽度	-	只读
m_nWinHeight	PDC统计窗高度	-	只读

窗口示意图

CPDFFirmwareFilter 参数说明

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

PDF 使能

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

PDF 参数

参数名	说明	建议调试	特殊性
m_nExtPRm	PD像素奇异点矫正使能0: 关闭PD像素奇异点矫正 1: 打开PD像素奇异点矫正	用户设置
m_nWA	中心块权重8为50%权重，一般中心点本身是被补偿的PD点，故权重一般设小一些。	否
m_nWB	对角块权重8为50%权重，一般设为50%	否
m_nFullWidth	sensor输出图像宽度	是
m_nFullHeight	sensor输出图像高度	是
m_nHOffset	水平方向ISP处理图像相对于sensor输出图像宽度的偏移量（见窗口示意图m_nHOft）	是
m_nVOffset	垂直方向ISP处理图像相对于sensor输出图像高度的偏移量（见窗口示意图m_nVOft）	是
m_bLRAdjust	方向控制：0: 关闭镜像 1: 打开镜像	是
m_bTBAdjust	方向控制：0: 关闭翻转 1: 打开翻转	是
m_bRefRB	0: 绿色通道矫正不参考RB通道 1: 绿色通道矫正参考RB通道	否
m_bRefCnr	0: 绿色通道矫正不参考角点信息 1: 绿色通道矫正参考角点信息	否
m_nRefNoiseL	用于判断边缘方向的当前噪声水平	否
m_nExtPThre	PD像素奇异点的门限	否
m_nExtPSft	PD像素奇异点的软阈值	否
m_nExtPOpt	PD像素奇异点矫正选择	否
m_pPDFirstX	水平方向PD区域相对于sensor输出图像宽度的偏移量（见窗口示意图）	是
m_pPDFirstY	垂直方向PD区域相对于sensor输出图像高度的偏移量（见窗口示意图）	是
m_pPixelMask	32x32的区域内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_nErrorDistCoef	distance（相关性拟合曲线距离）调节系数	否
m_nErrorShpCoef	shape（相关性拟合曲线形状）调节系数	否

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_nSearchRange	PD shift搜索范围，PD像素密度越大，该值越大。一般密度shield pixel设0，Dual PD设3，	是

图 Error-Confidence 转换曲线

CWbFirmwareFilter 参数说明

CWbFirmwareFilter 模块用于白平衡。

WB 使能

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

WB 参数

参数名	说明	建议调试	特殊性
m_bSyncWB	HDR模式白平衡同步方式选择：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_nAWBStableRange	AWB 进入稳定状态的门限：值越小，越不容易判定为AWB稳定	是
m_nAWBStableFrameNum	AWB 进入稳定状态的参考帧数：稳定帧数大于改值，判定为AWB稳定	是
m_nAWBUnStableRange	AWB 进入不稳定状态的门限：值越小，越容易判定为AWB不稳定	是
m_nAWBUnStableFrameNum	AWB 进入不稳定状态的参考帧数：不稳定帧数大于改值，判定为AWB不稳定	是
m_nAWBStep1	AWB 收敛的相对步长按比例计算步长，值越大，调整的比例越大，收敛的越快，准确性越低	是
m_nAWBStep2	AWB 收敛的绝对步长值越大，步长越大，调整的越快，准确性越低	是
m_nLowThr	参与AWB统计的亮度下限值越大，越多偏暗的区域不进行AWB统计	是
m_nHighThr	参与AWB统计的亮度上限值越小，越多偏亮的区域不进行AWB统计	是
m_nCorrelationCT	当前色温	-	只读
m_nTint	当前色调	-	只读
m_bAWBStableFlag	AWB当前状态	-	只读
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_bEnable	Special 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_0	UV旋转参数，定标参数	定标结果参数
m_pSuvTable_0	UV平移参数，定标参数	定标结果参数
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_nGainLut	GainWeight分段点，对应实际场景的值为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_bEnable	Curve使能0: 关闭伽马曲线 1: 打开伽马曲线	用户设置

Curve 控制参数

参数名	说明	建议调试	特殊性
m_bEbGtmAfterLinearcurve	GTM随线性曲线改变使能：0：gtm1 curve不变, 1：gtm1 curve 随线性曲线改变	否
m_nCurveSelectOption	Curve使用选择：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_pGainIndex	Gain分段控制点（见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_bEnable	LTM使能：0: 关闭局部色调映射 1: 打开局部色调映射	用户设置
m_bHistEnable	LTM 直方图使能：0: 关闭LTM 直方图 1: 打开LTM 直方图	否
m_nOffsetY	图像水平方向偏移，由输入图像大小确定	用户设置
m_nOffsetX	图像垂直方向偏移，由输入图像大小确定	用户设置

LTM 参数

参数名	说明	建议调试
m_nLtmStrength	Ltm强度，值越大，Ltm效果越强	是
m_nCurveAlpha	当前帧计算得到的曲线与历史保存曲线进行融合的收敛速度，值越小，收敛越快	是
m_nSlopeThr	DrcDrcDark < Thr，等效于GTM；DrcDrcDark >= Thr，每个块单独计算LTM强度	否
m_nPhicBeta	LTM曲线衰减控制点，值越小，曲线越早衰减，越多中高亮的块不会提亮(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_pDstAlphaGainIndex	LTM强度gain控制节点	否
m_pDstAlphaIndex	依据DstAlphaGainIndex控制节点调整LTM强度：值越大，LTM强度越大	是

PhicBeta 示意图

CUVDenoiseFirmwareFilter 参数说明

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

UVDenoise 使能

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

CEELiteFirmwareFilter 参数说明

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

EE 使能

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

CEELite 参数

参数名	说明	建议调试
m_pCurveLumaP	正边基于亮度自适应增强，值越大边越强	是
m_pCurveLumaN	负边基于亮度自适应增强，值越大边越强	是
m_pCurveFreqTxP	正边基于频率自适应增强，值越大纹理越多	是
m_pCurveFreqTxN	负边基于频率自适应增强，值越大纹理越多	是
m_nNodeFreq	频率调节节点
m_pGlobal_SharpenStrengthP	正边全局增强，值越大边越强	是
m_pGlobal_SharpenStrengthN	负边全局增强，值越大边越强	是
m_pGlobal_SharpenStrengthPCapture	拍照参数，正边全局增强，值越大边越强	是
m_pGlobal_SharpenStrengthNCapture	拍照参数，负边全局增强，值越大边越强	是
m_pLPF1	USMFilter滤波器参数	否
m_pLPF2	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_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_pCoffW	Halo区域判定参数	否
m_pGainIndex	增益控制节点（Q4）	否

EE Manual 参数

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

CBitDepthCompressionFirmwareFilter 参数说明

CBitDepthCompressionFirmwareFilter 模块用于降位深压缩。

Dithering 使能

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

CFormatterFirmwareFilter 参数说明

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

Formatter 参数

参数名	说明	建议调试
m_nOutputFormat	输出格式：0: NV12 1: P010 2：RGB888	否
m_nSwingOption	0: full swing, 1: studio swing	否
m_bConvertDitheringEnable	0: rgb2yuv dithering disable, 1: rgb2yuv dithering enable	否
m_bCompressDitheringEnable	0: full swing to studio swing dithering disable, 1: full swing to studio swing dithering enable	否

CEISFirmwareFilter 参数说明

CEISFirmwareFilter 模块用于电子防抖。

EIS 使能

参数名	说明	建议调试	特殊性
m_bEnable	EIS使能0: 关闭EIS计 1: 打开EIS	用户设置

EIS 参数

参数名	说明	建议调试
m_bCalcEnable	Firmware计算使能0: 关闭 1: 打开	用户设置
m_bFilterEnable	运动平滑滤波使能0: 关闭运动平滑滤波（一般设备与场景相对运动较少时关闭） 1: 打开运动平滑滤波	是
m_nRangeX	X方向检测移动的范围（单位为像素）	否
m_nRangeY	Y方向检测移动的范围（单位为像素）	否
m_nMarginX	LDC crop窗口的offset X	否
m_nMarginY	LDC crop窗口的offset Y	否
m_pFilterWeight	运动平滑滤波权重	是
m_pPeakConfLevel	置信度等级	是
m_pPeakErrorThre	置信度等级对应误差容忍门限	是
m_bReverseDirectionX	水平方向反转控制	是
m_bReverseDirectionY	垂直方向反转控制	是
m_nCenterStatRatio	中心统计比例，256为100%	是

CAECFilter 参数说明

CAECFilter（AEC）模块用于自动曝光控制。

AE 基础参数

参数名	说明	建议调试
m_bManualAEEnable	AEC模式选择: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_pRouteNode50Hz	50Hz曝光表,第一列为曝光时间,第二列为总体增益,第三列为精确增益控制(reserverd)	是
m_pRouteNode60Hz	60Hz曝光表,第一列为曝光时间,第二列为总体增益,第三列为精确增益控制(reserverd)	是
m_pMeteringMatrix	16x12测光权重表	用户设置
m_bLumaCalcMode	Luma计算方式 0：RGB max 1：Y average	用户设置
m_bQuickResponseEnable	AE快速响应开关，使能时立刻调节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_bLumaSelectOption	0：亮度计算不参考AEM中的6个sub ROI1：亮度计算参考AEM中的6个sub ROI
m_nStrategyMode	AE调整策略选择: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_nSmoothness	AE收敛平滑度调节，值越小，收敛越平滑	是
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_bLumaPredict	DRCgain计算亮度预测：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_nFrameCounter	AE帧计数	-	只读
m_pExpTimeLong	曝光时间(us)	-	只读
m_pAnaGainLong	模拟增益(Q8)	-	只读
m_pSnsDGainLong	sensor数字增益(Q12)	-	只读
m_pIspDGainLong	ISP数字增益(Q12)	-	只读
m_pTotalGainLong	总增益(Q8)	-	只读
m_pExpIndexLong	曝光索引(曝光时间 * 总增益 / 256)	-	只读
m_pTotalGainDBLong	总增益(db)	-	只读
m_pExpTimeShort	Reserved	-	只读
m_pAnaGainShort	Reserved	-	只读
m_pSnsDGainShort	Reserved	-	只读
m_pIspDGainShort	Reserved	-	只读
m_pTotalGainShort	Reserved	-	只读
m_pExpIndexShort	Reserved	-	只读
m_pTotalGainDBShort	Reserved	-	只读
m_nCurHdrRatio	Reserved	-	只读
m_nHistPixelNum	参与直方图统计的像素数	-	只读
m_pMeanLuma	AE计算亮度，[0]:long, [1]: Reserved	-	只读
m_pTargetLuma	AE目标亮度，[0]:long, [1]: Reserved	-	只读
m_pLuma7Zone	AE主窗口及6个副窗口luma	-	只读
m_pAERouteNum	AE曝光节点，[0]:long, [1]: Reserved	-	只读
m_pRouteNodeLong	长帧曝光表	-	只读
m_pADNodeLong	Sensor again与dgain分配表	-	只读
m_pLumaMatrixLong	亮度缩略图	-	只读
m_pHistLong	直方图	-	只读
m_pRouteNodeShort	Reserved	-	只读
m_pADNodeShort	Reserved	-	只读
m_pLumaMatrixShort	Reserved	-	只读
m_pHistShort	Reserved	-	只读
m_pRefSaturateNum	参考过曝像素数，[0]:long, [1]: Reserved	-	只读
m_pCurSaturateNum	当前过曝像素数，[0]:long, [1]: Reserved	-	只读
m_pEstSaturateNum	预估过曝像素数，预估当统计亮度达到目标亮度上限时过曝像素数，[0]:long, [1]:Reserved	-	只读
m_pAdjustRatio	AE调节比例	-	只读
m_pStableFlag	AE稳定标志，[0]:long, [1]: Reserved	-	只读
m_pStableFlagBuf	AE帧序列稳定标志，[0]:long, [1]: Reserved	-	只读
m_pUnStableFlagBuf	AE帧序列不稳定标志，[0]:long, [1]: Reserved	-	只读
m_nDRCGain	DRCGain当前帧AE计算结果	-	只读
m_nDRCGainDark	DRCGainDark当前帧AE计算结果	-	只读

CAFFilter 参数说明

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

AF 参数

参数名	说明	建议调试
m_nAFMode	对焦模式：0：SAF 单次聚集 1：CAF 连续聚焦	用户设置
m_bHybridAFEnable	CDAF与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时，电机走第一步时０：保持初始位置 1：走到最小电机位置或者最大电机位置，具体根据初始位置与首步方向判断百分比而定	用户设置
m_bPreMoveToInfMode	预运动模式，运动最小电机位置。AF算法运行在CDAF时，电机走第一步时０：保持初始位置 1：走到最小电机位置	用户设置
m_bStartFromTrueCurrent	从当前实际位置开始使能。AF算法运行在CDAF时，电机走第一步时０：走到距离初始位置最近的微距位置 1：保持初始位置	用户设置
m_nBackTimeRatio	电机运动时跳帧比例，值越大，电机走一步花费的帧数越多。与m_nBackTimeDivisor共同控制电机跳帧	用户设置
m_nBackTimeDivisor	电机运动时跳帧控制参数，值越小，电机走一步花费的帧数越多。与m_nBackTimeRatio共同控制电机跳帧	用户设置
m_nPreMoveTimeRatio	预运动模式下的电机跳帧比例	用户设置
m_nFailMotorPositionOpt ion	聚焦失败后最终位置选择：０：算法自动选择(需正确填写超焦距马达位置) 1：最清晰 2：无穷远 3：超焦距 4：微距 5：当前位置	用户设置

电机步长控制参数

参数名	说明	建议调试
m_nMinMacroReverseStepNum	当电机由最大电机位置到最小电机位置运动，检测到FV下降需要反向时，电机必须走过的步数	是
m_nMinReverseStepNum	当电机由最小电机位置到最大电机位置运动，检测到FV下降需要反向时，电机必须走过的步数	是
m_nFineStepSearchNum	细步长搜索的步数	是
m_nCoarseStep	CDAF下粗步长	是
m_nFineStep	CDAF下细步长	是

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

PDAF 控制参数

参数名	说明	建议调试
m_bPDReverseDirectionFlag	PDShift计算的步长反向标志0：不反向 1：反向	是
m_nPDDirectConfThrRatio	PD阈值百分比，当置信度大于阈值的m_nPDDirectConfThrRatio%时，直接走出PD计算的步长	否
m_nPDTryStepRatio	AF算法运行在混合对焦模式时，首先尝试走出的一步相对于CDAF大步的比例	否
m_nPDCoarseStep	PDAF粗步长	是
m_nPDFineStep	PDAF细步长	是
m_nPDStepDiscountRatio	PDAF对由PDShift计算出的步长的打折比例	否
m_pPDConfThr	PD信息置信度阈值	是
m_pPDFVIncreaseRatio	AF算法运行在混合对焦模式时，FV上升的比例，用于判定尝试的一步走出后FV值是否上升，从而判定PD信息是否可信	否
m_pPDFVDropPercentage	FV值下降的判定百分比，当AF运行在PDAF下	否
m_pPDShiftPositionLUT_0_0m_pPDShiftPositionLUT_4_4	5x5窗口，PD Shift – step 查找表	PDAF插件标定

连续聚焦控制

参数名	说明	建议调试
m_bCAFHold	在连续聚焦模式下，保持当前状态不变	用户设置
m_bCAFForce	在连续聚焦模式下，强制触发一次单次聚焦	用户设置
m_nCAFHoldPDShiftThr	连续聚焦模式下，判断场景稳定的PD shift门限，值越大，越容易判断为稳定	是
m_nCAFHoldPDConfThr	连续聚焦模式下，判断场景稳定的PD confidence门限，值越小，越容易判断为稳定	是
m_nPreFocusMode	在连续聚焦模式下，追焦模式使能：0：不追焦 1：半追焦（基于PD shift先尝试一次对焦）	用户设置
m_nPFPDStepDiscountRatio	Prefocus步长折扣比	是
m_nLumaCalcOpt	Luma计算方式0：三通道分别计算 1：计算RGB最大值 2：计算加权的Y均值	否
m_bReFocusEnable	连续聚焦模式下，refocus使能	用户设置
m_pRefocusLumaSADThr	CAF触发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_nPDShift	PD偏移	-	只读
m_nPDConf	PD置信度	-	只读
m_nCurrentPosition	当前电机位置	-	只读
m_nFSMStatus	AF状态机	-	只读
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_pFVUnchangeFlag	FV曲线过于平滑而失效的标志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_nRefocusLumaSAD	CAF触发SAF时，前帧亮度SAD	-	只读
m_nRefocusLumaSADThr	CAF触发SAF时，决定是否触发的SAD门限	-	只读
m_bStableExpIndexFlag	AE曝光表稳定标志位	-	只读
m_bStableFVFlag	FV稳定标志位	-	只读
m_bStableAFLumaFlag	AFM luma稳定标志位	-	只读
m_bStableAELumaFlag	AEM luma稳定标志位	-	只读
m_bPDTriggerCAF	PD触发AF标志位	-	只读
m_bFVTriggerCAF	FV触发AF标志位	-	只读
m_bLumaTriggerCAF	Luma触发AF标志位	-	只读
m_bExpIndexTriggerCAF	ExpIndex触发AF标志位	-	只读
m_bRefocusTriggerCAF	CFA触发SAF标志位	-	只读

CAWBFilter 参数说明

CAWBFilter（AWB）模块用于自动白平衡控制。

灰度世界

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

ROI 控制

参数名	说明	建议调试
m_pRoiBound	16个ROI区域控制	是
m_pRoiLumLutHigh	统计块亮度上限	否
m_pRoiLumLutLow	统计块亮度下限	否
m_pRoiEn	ROI使能	是
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_bWeightOnSum	Block权重计算方式：0：以block的和计算 1：以block的rgb gain计算	否

白平衡 Gain 控制

参数名	说明	建议调试
m_pAWBGainLimit	最终WB gain限制区域	是
m_nAWBCTShift	WB Gain向上偏移距离，用于将低色温场景往暖色调偏移	是
m_pAWBCTShiftThr	WB 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_nLog2CwtOverA	CWF与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_bAwbCalStatus	AWB计算状态	-	只读
CurrentResult	当前应用白平衡增益	-	只读
CurrentTarget	AWB计算得到的目标白平衡增益	-	只读
m_nSceneLux	AWB debug参数,当前AE计算得到的场景照度	-	只读
m_nValidBlkNum	有效统计块数	-	只读
m_nLowCtBlkRatio	低色温统计块占千分比	-	只读
m_pCtLimit	当前ROI范围（X_Max,X_Min,CT_High,CT_Low）	-	只读
m_nDayLightBlkRatio	D光统计块占千分比	-	只读
m_nGreenShiftWeight	绿区偏移权重	-	只读
m_pStatBlkR	R通道统计值	-	只读
m_pStatBlkG	G通道统计值	-	只读
m_pStatBlkB	B通道统计值	-	只读
m_pBlkCtX	统计块横坐标X	-	只读
m_pBlkCtY	统计块纵坐标Y	-	只读
m_pBlkRoiId	统计块所处ROI	-	只读
m_pBlkWeight	统计块参与白平衡计算的权重	-	只读
m_pDebugBlcokData[23][31]	AWB统计块的RGB值	-	只读

C3DNRFirmwareFilter 调试说明

C3DNRFirmwareFilter（NR）模块用于 2D 与 3D 去噪。

NR 使能

参数名	说明	建议修改	特殊性
m_nTnrEb	3DNR使能，仅用于控制3DNR	用户设置
m_pTnr3dYEb	3DNR 亮度去噪开关	是	可随Gain/Layer变化
m_pTnr3dUVEb	3DNR 颜色去噪开关	是	可随Gain/Layer变化
m_pTnr2dYEb	2DNR 亮度去噪开关	是	可随Gain/Layer变化

2D NR 基础控制参数

参数名	说明	建议修改	特殊性
m_pMax_diff_thr	最大亮度参考门限，Dynamic使能时有效	否
m_pSig_gain	亮度参考门限，值越小，越多区域被去噪	是	可随Gain/Layer变化
m_pAback_alpha	亮度噪声回加,值越大,回加的亮度噪声的越多	是	可随Gain/Layer变化
m_pCnrSig_y	CNR参考Y门限，值越大，越多区域被去噪	是	可随Gain/Layer变化
m_pCnrSig_uv	CNR参考UV门限，值越大，越多区域被去噪	是	可随Gain/Layer变化
m_pCnrAback_alpha	颜色噪声回加,值越大,回加的颜色噪声的越多	是	可随Gain/Layer变化
m_pCnrSig_uv_shift	CNR门限左移系数，（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_en	YNR随亮度变化使能	用户设置
m_pLuma_sig	随亮度变化, 2D YNR强度，level 0-16 对应亮度0-255, 16等分	是	可随Gain/Luma变化
m_bCnrLuma_en	CNR强度随亮度控制使能	用户设置
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_pTnrYStrengthQ6	Tnr亮度去噪全局强度，值越大，静止区域亮度去噪强度越大	是	可随Gain/Layer变化
m_pTnrUVStrengthQ6	Tnr颜色去噪全局强度，值越大，静止区域颜色去噪强度越大	是	可随Gain/Layer变化
m_pStrongSig_gain	运动区域亮度去噪参考门限，值越小，越多区域被去噪	是	可随Gain/Layer变化
m_pStrongAback_alpha	运动区域亮度噪声回加，值越大，回加噪声越多	是	可随Gain/Layer变化

3D NR 其他参数参数

参数名	说明	建议修改
m_nTnrLumaWeight	计算luma的窗口大小	否
m_pTnrBlockWeight0	Layer0计算亮度差的窗口大小	否
m_pTnrBlockWeight1	Layer1计算亮度差的窗口大小	否
m_pTnrBlockWeight234	Layer2,3,4计算亮度差的窗口大小	否
m_pTnr2dMappingCurve	运动区域不同亮度去噪强度融合系数，值为256全用weak(静止区域)去噪强度，值为0时strong(运动区域)权重最大	否
m_p*Ratio	Reserved

彩边抑制

彩边抑制功能由过曝点和 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_pGTMCurveSet	GTM曲线，5组对应长短曝光倍数1,4,16,64,256	否

File to File

File to File 功能说明

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

File to File 使用说明

通过 USB 将设备与 PC 相连；
通过 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
启动 camera，即可看到经过 ISP 处理的 VRF 预览效果，也可拍摄为 JPG；

Tuning 参数快速验证

Tuning 参数快速验证功能说明

平台支持 tuning 参数快速验证功能，打开如下 property

adb shell setprop persist.vendor.camera.enable.settingfile 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:显示后一张图像

ISP PQ Tool User Guide

简介​

概述​

缩略语​

Tuning Tool 概述​

Tuning Tool 框架​

PC 端 tuning tool 安装​

调试环境准备​

软硬件需求​

设备连接​

Tuning Tool 基本操作​

Tuning Tool 主界面​

Online 基本操作​

连接终端设备​

参数类型说明​

实时修改参数​

抓取 VRF 图​

Register 读写​

I2C 读写​

保存参数​

打开本地参数文件​

Offline 基本操作​

ISP 插件​

BLC 定标与调试​

BLC 定标 VRF 图要求​

BLC 定标步骤​

BLC 定标说明​

BLC 调试说明​

LSC 定标与调试​

LSC 定标 VRF 图要求​

LSC 定标步骤​

LSC 定标说明​

LSC 调试说明​

CCM 与 CCT 定标与调试​

CCM 定标 VRF 图要求​

CCM 定标步骤​

CCT 定标步骤​

CCM 定标说明​

CCM 调试说明​

AWB 定标与调试​

AWB 白点定标 VRF 图要求​

AWB 白点定标步骤​

AWB 亮度定标​

AWB Debug​

Block debug 信息​

ROI 中的白点​

Block 的权重​

白平衡 gain 的落点​

AWB 调试说明​

Curve 调试​

Curve 调试步骤​

Curve 调试说明​

Noise 定标与调试​

Noise 定标 RAW 图要求​

Noise 定标步骤​

Noise 定标说明​

PDAF 定标​

PDAF 定标 VRF 图要求​

PDAF 定标步骤​

PDC 定标​

PDC 定标 VRF 图要求​

PDC 定标步骤​

PDC 定标说明​

Raw preprocessor 插件​

Raw preprocessor 插件说明​

Raw preprocessor 插件使用​

General Information 插件​

General Information 显示​

General Information 拓展​

ISP Tuning​

CTopFirmwareFilter 调试说明​

TOP 参数​

CAEMFirmwareFilter 参数说明​

AEM 使能及参数​

CDigitalGainFirmwareFilter 参数说明​

DigitalGain 使能及参数​

CWBGainFirmwareFilter 参数说明​

WBGain 使能​

CStretchFirmwareFilter 参数说明​

Stretch 使能​

简介

概述

缩略语