关键词：RK3568 RKAIQ ISP21 Dehaze Enhance Histogram 去雾 对比度增强 IQ Tuning GC2053
适用平台：RK3568 / RV1126 / RK3588（ISP21 框架通用）
作者笔记：本文基于 gc2053_default_JX8006.json 实战调试过程整理

📑 文章目录

  • 前言
  • 一、Dehaze 是什么
  • 二、最常用的 4 件事
  • 三、整体架构
  • 四、顶层参数详解
  • 五、dehaze_setting 去雾模块
  • 六、enhance_setting 对比/色度增强
  • 七、hist_setting 直方图增强
  • 八、当前 IQ 文件状态分析
  • 九、实战调试经验
  • 十、与其他模块协同
  • 十一、调试 SOP
  • 十二、板端验证流程
  • 十三、一图速查
  • 十四、Cheat Sheet 典型场景配置
  • 总结
  • 参考资料

前言

adehaze_calib_v11 是 RKAIQ ISP21 框架中的：

三合一画面增强模块
它包含：
| 子模块 | 作用 |
|---|---|
| dehaze_setting | 去雾 |
| enhance_setting | 对比/色度增强 |
| hist_setting | 直方图增强 |
整体数据流：

ADRC
   ↓
adehaze_calib_v11
   ├─ dehaze
   ├─ enhance
   └─ hist
   ↓
Gamma

一、Dehaze 是什么

一句话理解：

子模块 类比
去雾 扒开白雾
Enhance 给画面加通透感
Histogram 挖暗部细节

为什么三个功能放一起

因为：

它们都依赖亮度统计与直方图分析

共享：

  • dark channel
  • histogram
  • luminance statistics

二、最常用的 4 件事

想要效果 改哪里 推荐
画面发灰 enhance_value 1.3~1.4
暗部细节不够 hist_gratio 3.0~4.0
有雾/烟尘 dehaze.en 0→1
色彩不鲜艳 enhance_chroma 1.4~1.6

⚠️ 注意

增强过猛会导致：

  • 噪点放大
  • 色彩塑料感
  • banding
  • 肤色异常

三、整体架构

adehaze_calib_v11
└── DehazeTuningPara
    ├── Enable
    ├── CtrlDataType
    ├── cfg_alpha
    ├── ByPassThr
    │
    ├── dehaze_setting
    │   ├── en
    │   ├── air_lc_en
    │   ├── stab_fnum
    │   └── DehazeData
    │
    ├── enhance_setting
    │   ├── en
    │   ├── enhance_curve
    │   └── EnhanceData
    │
    └── hist_setting
        ├── en
        ├── hist_para_en
        └── HistData

四、顶层参数详解

4.1 Enable 总开关

值 含义
1 启用
0 关闭

⚠️ 注意

即使：

"Enable": 1

如果子模块：

"en": 0

对应功能仍然不会生效。

4.2 CtrlDataType

控制轴类型

值 含义 推荐
ENVLV 按环境亮度 ✅
ISO 按 ISO 特殊场景

EnvLv 含义

EnvLv 场景
0 极暗
0.1 弱光
0.5 普通室内
1.0 强光室外

推荐

CTRLDATATYPE_ENVLV

因为：

更符合人眼亮度感知

4.3 cfg_alpha

自动/手动混合系数。

值 含义
0 全自动
1 全手动
0~1 混合

推荐

0

4.4 ByPassThr

"ByPassThr": 0.01

含义：

EnvLv 变化很小时不重新计算

作用：

减少算力开销

五、dehaze_setting 去雾模块

⭐ 真正的去雾算法

5.1 en

值 含义
0 关闭
1 开启

当前状态

"en": 0

表示：

当前去雾关闭

为什么默认关闭

因为：

普通室内场景没必要去雾

否则容易：

  • 过对比
  • 肤色发蓝
  • 暗部噪点放大

5.2 全局参数

参数 默认 含义
air_lc_en 1 空气光局部计算
stab_fnum 8 稳定帧数
sigma 255 滤波强度
wt_sigma 8 权重平滑
air_sigma 120 空气光平滑
tmax_sigma 0.01 透射率平滑
pre_wet 8 预湿润系数

调试建议

基本保持默认

5.3 DehazeData

13 档 EnvLv 控制表：

"CtrlData": [
0,0.005,0.01,0.05,
0.1,0.15,0.2,0.3,
0.4,0.5,0.6,0.8,1
]

核心参数

参数 作用 调强
dc_min_th 暗通道最小阈值 减小
dc_max_th 暗通道最大阈值 增大
wt_max 去雾权重 增大
tmax_base 透射率基础值 减小
tmax_off 透射率偏移 减小

轻度去雾推荐

"wt_max": [0.7,0.7,0.7,...]
"tmax_base": [125,125,125,...]

强力去雾推荐

"wt_max": [0.95,0.95,0.9,...]
"tmax_base": [80,80,90,...]

六、enhance_setting 对比/色度增强

⭐⭐⭐ 最常调模块

6.1 en

当前：

"en": 1

表示：

已开启增强

6.2 enhance_curve

17 点局部对比度 LUT：

[0,64,128,192,256,320,384,448,
512,576,640,704,768,832,896,960,1023]

当前状态

线性映射

常见曲线风格

风格 特点
线性 自然
S 型 中段通透
缓启动 防止过冲

6.3 enhance_value

⭐ 亮度对比增强

推荐范围

值 效果
1.0 不增强
1.1~1.2 轻度增强
1.3~1.5 强增强
>1.5 易 banding

当前配置

[1.25,1.25,1.25,
1.2,1.2,1.2,
1.1,1.1,
1.05,1.05,
1,1,1]

当前逻辑

暗场强增强
亮场弱增强

6.4 enhance_chroma

⭐ 色彩饱和度增强

推荐范围

值 效果
1.0 默认
1.1~1.3 自然鲜艳
1.4~1.6 浓郁风
>1.6 塑料感

当前配置

[1.5,1.4,1.3,
1.2,1.2,1.2,
1.1,1.1,
1.05,1.05,
1,1,1]

当前策略

暗场补色彩
亮场不增强

七、hist_setting 直方图增强

⭐ 挖暗部细节

7.1 开关

参数 作用 当前
en 总开关 ✅
hist_para_en 13 档使能 ✅

7.2 HistData

参数 作用
hist_gratio 全局拉伸比例
hist_k 增益
hist_scale 增强强度
hist_min 最小阈值

当前配置

"hist_gratio":
[2.5,2.5,2.5,2.4,2.3,
2.2,2.0,2.0,
1.8,1.6,1.4,1.2,1.0]
"hist_scale":
[0.12,0.12,0.11,
0.11,0.10,0.10,
0.09,0.09,
0.08,0.08,
0.07,0.06,0.05]

当前策略

暗场强增强
亮场弱增强

八、当前 IQ 文件状态分析

模块 状态 评价
顶层 Enable ✅ 已开启
dehaze ❌ 关闭
enhance ✅ 已优化
hist ✅ 已优化

当前适合场景

✅：

  • 室内监控
  • 白天场景
  • 一般 IPC
    ⚠️ 不适合：
  • 雾天
  • 烟尘环境
  • 远距离场景

九、实战调试经验

经验 1：先调 enhance

顺序：

enhance
   ↓
hist
   ↓
dehaze

原因：

dehaze 最容易翻车

经验 2：必测 3 个场景

场景 看什么
白墙/天空 是否 banding
人脸 肤色是否异常
暗部 是否增噪

经验 3：去雾 5 大坑

坑 1：晴天过对比

解决：

"wt_max": [0.9,0.8,0.7,...]

坑 2：暗部噪点暴增

解决：

低 EnvLv 降低 wt_max

坑 3：白边光晕

解决：

"tmax_off": [0.15,0.15,...]

坑 4：画面闪烁

解决：

"stab_fnum": 16

坑 5：夜晚偏绿

解决：

极暗 EnvLv 关闭去雾

十、与其他模块协同

ADRC
   ↓
Enhance
   ↓
Gamma
   ↓
CPROC

⚠️ 不要四处同时加对比

否则：

容易过冲

推荐组合

风格 ADRC Enhance Gamma Contrast
自然 0.2 1.1 中 S 130
均衡 0.3 1.2 标准 S 142
高对比 0.4 1.3 强 S 150

十一、调试 SOP

1. 全关
2. 只开 enhance
3. 再开 hist
4. 最后评估是否需要 dehaze
5. 跑全场景
6. 看录像稳定性
7. 微调 13 档曲线

十二、板端验证流程

推送 IQ

adb push gc2053_default_JX8006.json /oem/etc/iqfiles/

启动 RTSP

rkmedia_vi_venc_rtsp_test -a /oem/etc/iqfiles

必测场景

场景 重点
白墙/蓝天 banding
人脸 肤色
夜景 色偏
逆光 暗部
场景切换 闪烁

十三、一图速查

想做什么 改哪里 怎么改
更通透 enhance_value +0.1
更鲜艳 enhance_chroma +0.1
暗部更亮 hist_gratio 暗段 +0.5
开启去雾 dehaze.en 0→1
去雾更强 wt_max +0.05
降低噪点 hist_scale ×0.7
减少 banding enhance_value -0.1
防止闪烁 stab_fnum 8→16

十四、Cheat Sheet 典型场景配置

场景 A：室内监控

"dehaze.en": 0
"enhance.en": 1
"hist.en": 1

场景 B：室外白天

"dehaze.en": 1
"enhance_value": +0.05
"hist_gratio": 略减

场景 C：夜景逆光

"dehaze.en": 0
"hist_gratio": [3.5,3.5,3.0,...]

总结

Dehaze 模块的本质：

提升画面通透感

它决定：

  • 对比度
  • 色彩鲜艳度
  • 暗部层次
  • 雾天可视性
    真正项目里最重要的是：
少即是多

因为：

增强过头一定翻车

因此：

  • 先调 enhance
  • 再调 hist
  • 最后才碰 dehaze
    才是正确的调参方式。

参考资料

  1. Rockchip RKAIQ Framework Documentation
  2. RKAIQ ISP21 Dehaze Calibration Guide
  3. RKMedia Developer Guide
  4. GC2053 Datasheet
  5. RKAIQ Source Code
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

2026年 国内企业AI部署开发公司推荐指南

avatar AtomGit开源社区

基于密集型复杂城市场景下求解无人机三维路径规划的Q-learning 算法研究（Matlab代码实现）

随着无人机在城市环境中应用的不断拓展，如物流配送、航拍测绘、交通监控等，其三维路径规划问题日益受到关注。密集型复杂城市场景具有障碍物密集、三维空间约束复杂、实时性要求高等特点，传统路径规划算法难以满足需求。Q-learning算法作为一种强化学习方法，具有无需环境模型、通过试错学习等优点，适合应用于此类场景。本文深入研究基于Q-learning算法的无人机三维路径规划方法，通过合理定义状态空间、动

avatar AtomGit开源社区

ollama v0.23.3 发布：MLX 性能优化、安全加固与传输并发控制

代码地址：github.com/ollama/ollamaOllama v0.23.3 是一个以稳定性和安全性为主的维护版本。MLX 后端的多项优化显著改善了 Apple Silicon 平台上的推理体验，更新机制的加固为用户提供了更安全的自动升级保障，而传输并发控制的引入则为受限网络环境下的模型分发提供了灵活调整空间。建议所有用户升级到此版本，特别是 macOS 用户和启用了自动更新的 Wind

avatar AtomGit开源社区