关键词：RK3568 RKAIQ ISP21 LSC_V2 Lens Shading Correction 暗角校正 Vignetting Lens Shading IQ Tuning GC2053
适用平台：RK3568 / RV1126 / RK3588（ISP21 框架通用）
作者笔记：本文基于 gc2053_default_JX8006.json 实战调试过程整理

---

📑 文章目录

• 前言
• 一、LSC_V2 是什么
• 二、为什么镜头会出现暗角
• 三、LSC_V2 整体结构
• 四、common 通用配置
• 五、alscCoef 自动 LSC 系数配置
• 六、tbl 实际 LSC 校正表
• 七、uCoeff 系数含义
• 八、GRAY 光源特殊逻辑
• 九、LSC_V2 工作流程
• 十、当前 IQ 文件状态分析
• 十一、实战调试经验
• 十二、LSC 与其他模块协同
• 十三、一图速查
• 十四、LSC 调试铁律
• 总结
• 参考资料

---

前言

lsc_v2 是 RKAIQ ISP21 框架中的：

LSC（Lens Shading Correction）镜头阴影校正模块
主要作用：

修复镜头暗角
修复边缘偏色

它用于解决：

镜头中心亮
边缘暗

的问题。

一、LSC_V2 是什么

一句话理解：

给图像四周增加增益
补偿镜头暗角

---

为什么必须有 LSC

因为：

所有镜头都有光学衰减

表现为：

• 四周发暗
• 边缘偏色
• 不同颜色衰减不同

---

LSC 的本质

中心少增益
边缘多增益

形成：

反向 vignette

---

二、为什么镜头会出现暗角

原因 1：镜头余弦四次方定律

离中心越远
入射角越大

导致：

亮度下降

---

原因 2：微透镜效率下降

边缘：

聚光效率更低

---

原因 3：IR-CUT 与 CRA 不匹配

导致：

边缘偏色

---

三、LSC_V2 整体结构

lsc_v2
├── common
├── alscCoef
└── tbl

---

四、common 通用配置

"common": {
    "enable": 1,
    "resolutionAll": [{
        "name": "1920x1080"
    }]
}

---

4.1 enable

值	含义
1	开启 LSC
0	关闭 LSC

---

推荐

"enable": 1

---

为什么必须开

关闭后：

画面四周明显发暗

---

4.2 resolutionAll

当前配置

"name": "1920x1080"

---

含义

表示：

当前 LSC 表
对应 1920×1080

---

4.3 lsc_sect_size_x

当前配置

[120,120,120,120,120,120,120,120]

---

含义

水平方向 8 个区域

---

为什么是 120

因为：

120 × 8 × 2 = 1920

---

4.4 lsc_sect_size_y

当前配置

[67,68,67,68,67,68,67,68]

---

含义

垂直方向 8 个区域

---

为什么是 540

因为：

67×4 + 68×4 = 540

对应：

1080 / 2

---

4.5 网格结构

LSC_V2：

16×16 网格

对应：

17×17 控制点

因此：

289 个采样点

---

五、alscCoef 自动 LSC 系数配置

"alscCoef": {
    "damp_enable": 1,
    "illAll": [...]
}

---

5.1 damp_enable

值	含义
1	平滑切换
0	立即切换

---

推荐

"damp_enable": 1

---

原因

避免：

光源切换闪烁

---

5.2 illAll

当前共有 8 个光源

光源	含义
A	钨丝灯
CWF	冷白荧光
D50	日光 5000K
D65	日光 6500K
D75	冷日光
HZ	钠灯
TL84	欧标荧光
GRAY	灰场

---

5.3 wbGain

当前格式

[1.1857, 2.5794]

---

含义

[R_gain, B_gain]

用于：

匹配当前光源

---

5.4 tableUsed

当前格式

[
"A_70",
"A_100"
]

---

含义

当前光源对应的 LSC 表

---

5.5 gains

当前配置

[1,4,8,16]

---

含义

对应：

Sensor Gain 档位

---

5.6 vig

当前配置

[70,70,70,70]

---

含义

暗角校正强度

---

数值规律

值	效果
小	校正弱
大	校正强

---

六、tbl 实际 LSC 校正表

"tbl": {
    "tableAll": [...]
}

---

当前共有

15 张 LSC 表

---

表组成

类型	数量
7 个光源 × 2 档	14
GRAY_0	1

---

表名格式

<分辨率>_<光源>_<vig>

例如：

1920x1080_A_70

---

七、uCoeff 系数含义

当前结构

"lsc_samples_red": {
    "uCoeff": [...]
}

---

四个通道

通道	含义
red	R
greenR	Gr
greenB	Gb
blue	B

---

7.1 uCoeff 的本质

每个位置的增益

---

基准值

1024 = 1.0×

---

举例

数值	增益
1024	1.0×
2048	2.0×
3072	3.0×

---

7.2 当前典型分布

中心：

1024~1100

边缘：

2500~2900

---

含义

中心少增益
边缘大增益

---

八、GRAY 光源特殊逻辑

"name": "GRAY"

---

特殊用途

低照度兜底

---

当前配置

"vig": [90,60,25,0]

---

含义

高 gain：

逐渐关闭 LSC

---

原因

因为：

LSC 会放大角部噪声

---

九、LSC_V2 工作流程

AWB 估计色温
    ↓
LSC 匹配最近光源
    ↓
根据 gain 查 vig
    ↓
插值生成最终表
    ↓
应用到 Bayer RAW

---

十、当前 IQ 文件状态分析

模块	状态	评价
enable	✅	已开启
分辨率	✅ 1920×1080	正确
光源表	✅ 8 类	完整
damp_enable	✅	已开启
GRAY	✅	已优化
uCoeff	✅	正常

---

当前评价

属于标准成熟配置

---

十一、实战调试经验

经验 1：角部发暗

解决：

提高角部 uCoeff

---

经验 2：边缘偏蓝

解决：

提高 blue 通道角部增益

---

经验 3：边缘偏黄

解决：

提高 blue
降低 red

---

经验 4：低照度噪点严重

解决：

高 gain 降低 vig

---

经验 5：切换色温闪烁

解决：

"damp_enable": 1

---

十二、LSC 与其他模块协同

BLC
 ↓
LSC
 ↓
AWB
 ↓
CCM

---

⚠️ 为什么顺序重要

因为：

LSC 会影响颜色分布

AWB：

必须基于校正后数据

---

十三、一图速查

想做什么	改哪里	怎么改
四周更亮	uCoeff 角部	增大
四周更暗	uCoeff 角部	减小
边缘偏蓝	blue uCoeff	增大
边缘偏黄	red↓ blue↑	调整
低照度降噪	GRAY vig	降低
防闪烁	damp_enable	1

---

十四、LSC 调试铁律

铁律 1

必须用积分球

---

铁律 2

不同镜头必须重标定

---

铁律 3

高 gain 不要强校正

---

铁律 4

先调亮度
再调颜色

---

总结

LSC_V2 的本质：

修复镜头暗角

它决定：

• 四周亮度
• 边缘颜色
• 画面均匀性
  真正项目里最重要的是：

自然
平滑
不过校正

因此：

• 中心少增益
• 边缘多增益
• 高 gain 降低校正
• 光源切换平滑
  才是正确的 LSC 调参方式。

---

参考资料

1. Rockchip RKAIQ Framework Documentation
2. RKAIQ ISP21 LSC Calibration Guide
3. GC2053 Datasheet
4. RKMedia Developer Guide
5. RKAIQ Source Code