Android Camera 全栈课程 — 章节大纲

设计理念

全栈覆盖：覆盖 App → Framework → HAL → Driver → Hardware 完整知识栈

螺旋式上升：

• 🌱 入门篇 — 能看、能操作、能跑通，建立全景认知
• 🌿 进阶篇 — 懂原理、懂架构、懂源码，掌握核心机制
• 🌳 深入篇 — 能调试、能定制、能优化，具备工程实战能力

每章统一结构：

1. 本章目标 — 学完能做什么
2. 概念图解 — 框架流程图/时序图/拓扑图
3. 代码走读 — 关键源码片段 + 标注
4. 实操环节 — setprop 调试、logcat 分析
5. 常见问题 — 实际开发中的坑

---

🌱 第一篇：初识相机（第 1~3 章）

零基础入门，建立相机系统全景认知，搭建开发环境

第 1 章：相机成像基础

• 从物理成像到数字图像 — 镜头、光圈、快门、ISO
• 传感器（CMOS/CCD）、Bayer 阵列、颜色空间
• 配套图表：成像光路图、Bayer 排列图、RAW→YUV→JPEG 转换流程图

第 2 章：Android Camera 系统全景

• Android Camera 整体架构分层图（App → Framework → HAL → Kernel → HW）
• Camera2 API vs Camera1 API 演化
• App Process → CameraService → CameraProvider → HAL 进程架构
• 配套图表：全栈架构图、进程通信架构图

第 3 章：开发环境与调试基础

• 源码目录结构（camx/ chi-cdk/ 划分逻辑）
• Source Insight / VS Code 工程配置
• logcat 过滤技巧（[CamX] / [CHI] 标签体系）
• adb 命令大全（dumpsys media.camera、setprop）
• camxoverridesettings.txt 详解
• 配套图表：源码目录树 + 速查表

---

🌱🌿 第二篇：App 层 — Camera2 API 编程（第 4~6 章）

从应用开发者的视角理解 Camera，能自己写相机 App，理解 CaptureRequest/CaptureResult 模型

第 4 章：Camera2 API 核心概念

• CameraManager、CameraCharacteristics、CameraDevice、CaptureRequest、CaptureResult 五大核心类
• StreamConfigurationMap 解读
• Session 参数模板
• 配套图表：Camera2 API 类关系图、Stream 配置决策树

第 5 章：Camera2 实战 — 预览/拍照/录像

• 预览流程、拍照 capture + 回调、录像 MediaRecorder
• ImageReader / SurfaceView / TextureView 选择
• 完整可运行的 Minimal Camera App 示例
• 配套图表：预览/拍照/录像时序流程图

第 6 章：Camera2 高级特性 ⭐⭐

• 手动曝光/对焦
• 多摄像头选择（Logical Camera）
• RAW 输出与 DNG
• YUV_420_888 格式详解：Stride / RowStride / PixelStride 图解
• 配套图表：YUV420 内存布局图（NV12/NV21 对比）

---

🌿 第三篇：Framework 层（第 7~9 章）

深入 Android 相机框架层，理解 CameraService 如何调度请求

第 7 章：CameraService 架构

• CameraService 启动与注册（SystemServer）
• CameraProvider 进程模型：CameraProviderManager → ICameraProvider
• HAL3.4 与 HAL3.6 差异
• CameraDeviceClient / CameraStateMachine
• 配套图表：CameraService → Provider → HAL 调用链图

第 8 章：Metadata 系统

• CameraMetadata 数据结构（camera_metadata.h）
• Vendor Tag 注册与查询机制
• Request → Result 的 metadata 流转路径
• Vendor Tag 实例：org.quic.camera.eis3enable
• 配套图表：Metadata 序列化/反序列化流程图

第 9 章：Surface / BufferQueue / Buffer 管理

• Surface 与 BufferQueue 的 producer-consumer 模型
• Gralloc / ION / DMA-BUF 分配器
• Buffer 全生命周期：App → Framework → HAL → ISP HW
• 配套图表：BufferQueue 机制图、Buffer 全生命周期流程图

---

🌿🌳 第四篇：HAL 层 — CamX-CHI 架构深度解析（第 10~17 章）

课程精华部分，深度拆解 CamX-CHI 架构。每章配合源码走读 + 框架图

第 10 章：CamX-CHI 架构全景

• CamX 与 CHI 的两层设计哲学
• 为什么 Google HAL3 之上还需要 CamX+CHI？
• HAL 内部架构详解：App → HAL3 Entry → CamX Core → CHI CDK → KMD → CSL → ISP HW
• 配套图表：CamX-CHI 完整架构图（含 HAL 内部展开 + 数据流方向）

第 11 章：HAL3 入口与 CamX 初始化

• HAL_MODULE_INFO_SYM 加载（camxhal3module.cpp）
• camera3_device_t open / configure_streams / process_capture_request
• ChiContext 初始化流程
• Static Metadata 构建（InitializeStaticMetadataPool()）
• CameraInfo 获取：facing/orientation 的 roll/pitch/yaw 判定
• 配套图表：HAL3 入口初始化序列图、facing 判定流程图

第 12 章：Usecase — 场景调度中心

• Usecase 继承体系（UsecaseDefault / HDR / MFNR / Video）
• UsecaseSelector：根据 Stream 配置自动匹配 Usecase 的决策树
• UsecaseDefault::Create() 完整走读
• Usecase 管理 Session：m_realTimeIdx / m_offlineIdx
• ISP 带宽约束与 Offline Pipeline 管理
• 配套图表：Usecase 继承体系图、UsecaseSelector 决策树、实时/离线 Pipeline 分配图

第 13 章：Session 与 Pipeline — 请求编排引擎 ⭐⭐⭐

• Session（camxsession.h）：Pipeline 容器，Request/Result 分发汇聚
  • PipelineInfo / LinkInfo / PortInfo / NodeInfo
  • MaxRealTimePipelines=4 / MaxActiveRealtimePipelines=2
• Pipeline 状态机（camxpipeline.h）：8 个状态迁移
  • UNINITIALIZED → INITIALIZED → FINALIZED → RESOURCES_RELEASED
  • STREAM_OFF → RESOURCES_ACQUIRED → PARTIAL_STREAM_ON → STREAM_ON
• PipelineFlags：hasStatsNode / isSecureMode / isHFRMode / hasIFENode
• Session 如何分解 Request 到 Pipeline
• 配套图表：组件层次图、Pipeline 状态机图

第 14 章：Node 机制 — 最小的处理单元 ⭐⭐⭐

• Node 生命周期：Create → Initialize → Activate → ProcessRequest → ProcessResult → Destroy
• DependencyUnit 核心：异步并行的关键
  • hasInputBuffersReadyDependency
  • hasPropertyDependency
  • hasFenceDependency
• HW Node（IFE/BPS/IPE）与 SW Node（SWMF/EIS/JPEG）区别
• Port/BufferProperties：queueDepth、format、width/height
• Node 间 Dependency Graph 解析
• 实战示例：Node 中的 watermark 水印处理代码
• 配套图表：Dependency 图解析流程、Node 状态机图

第 15 章：ISP 管线详解 — IFE/BPS/IPE/JPEG ⭐⭐⭐

• IFE（Image Front-End）：MIPI CSI 接收 → RAW 预处理 → Stats 采集
• BPS（Bayer Processing Segment）：Bayer 域处理
• IPE（Image Processing Engine）：YUV 域处理
• JPEG Node：编码 + EXIF 生成
• SWMF Node：多帧融合
• 实时 Pipeline vs 离线 Pipeline 拓扑差异
• Port/Link 连接方式
• 配套图表：Preview Pipeline 拓扑图、Snapshot Pipeline 拓扑图、ISP 处理流水线流程图

第 16 章：Feature2 框架 — 灵活的功能组合

• Feature2 要解决什么问题
• Feature Descriptor：名称、依赖、Pipeline 映射、Port 描述
• Feature Graph：XML 配置结构
• Feature Request Object (FRO)：每个 Request 创建一次
• Feature2 Wrapper → Session → Pipeline 调用链
• 典型 Feature Graph：Bokeh / HDR / MFNR / SuperNight
• 配套图表：Feature2 组件关系图、FRO 生命周期图

第 17 章：Request → Result 数据流全链路 ⭐⭐⭐

• App → HAL3 → Usecase → Session → Pipeline → Node → CSL → HW 完整时序
• Dependency Graph 解析算法
• Buffer Fence 机制：CSL Fence signal/wait
• Metadata 传递（PerNodeMetadata / PipelineMetadata）
• Result 回传路径：HW Interrupt → CSL FenceSignaled → Node → Session → CHI → HAL3 → App
• 关键日志分析：[REQMAP]、frameMessage
• 配套图表：完整请求-结果时序图

---

🌳 第五篇：Driver 与硬件层（第 18~21 章）

深入内核与硬件，掌握 Sensor Bringup 等底层技能

第 18 章：Camera Kernel 驱动框架

• V4L2 框架与 msm_camera 驱动的区别
• 驱动分层：CSIPHY → CSID → Sensor/EEPROM/Actuator/Flash
• probe 流程：platform_driver → 设备树匹配 → 子设备注册
• I2C/CCI 通信协议
• 配套图表：Kernel 驱动分层架构图、probe 时序图

第 19 章：Sensor Bringup 实战 ⭐⭐⭐

• DTSI 配置详解（csiphy / 电源 / GPIO / clock）
• sensor-position-roll/pitch/yaw → facing/orientation 映射
• Sensor 驱动代码：power up / power down 序列
• Camera XML 配置（mm-camera）
• vendor 层配置：device-vendor.mk / camera_config.xml
• 常见问题：probe 失败、mclk 没输出、I2C 通信异常
• 配套图表：DTSI 配置与硬件映射图、power up 时序图

第 20 章：OTP / EEPROM / Actuator / Flash

• OTP 数据存储结构：AF / AWB / LSC 校准数据
• OTP Dump 方法（mm-camera / camx 两种方式）
• OTP Guide：AWB r/g b/g gr/gb 验证、LSC table 校验
• Actuator 驱动与 AF 校准
• Flash / LED 驱动配置
• 配套图表：OTP 数据结构图、EEPROM 驱动栈

第 21 章：3A 算法与 Tuning 基础

• AE（Auto Exposure）：曝光策略、AEC 算法、帧率控制
• AWB（Auto White Balance）：色温估计、CCM 矩阵
• AF（Auto Focus）：CDAF / PDAF / Hybrid AF
• Stats Node：3A 统计数据 HW 采集与 SW 解析
• Chromatix Tuning 文件：结构、加载路径、常用参数
• 配套图表：3A 控制环路图、Stats 数据流转图

---

🌳 第六篇：调试、优化与认证（第 22~25 章）

解决实际工程问题，提升代码质量和稳定性

第 22 章：调试工具与方法 ⭐⭐

• CamX 日志系统：camxLogGroup 分组、overrideLogLevels
• Session Dump 分析：拓扑、Node 耗时、Buffer 状态
• Frame Rate 调试：SOF log、enableFPSLog、DumpNodeProcessingInfo
• Raw Dump / ISP Dump
• logcat 日志分析实战
• 配套图表：Session Dump 解读指南、帧率分析流程图

第 23 章：性能优化

• Launch Time 优化：Provider 加载 → HAL 初始化 → configureStream → first frame
• Preview FPS 优化：ISP 瓶颈、Node 耗时、Stats 开销
• Capture Latency 优化：JPEG 编码优化、ZSL 模式
• Memory / Power 优化
• 配套图表：Launch Time 分解图、Perf KPI 流水线图

第 24 章：CTS / 认证测试

• Camera CTS 架构：android.hardware.camera2.cts.*
• 高频失败项分析：帧率、格式、3A 稳定性、YUV 校验
• PrivilegedApp 机制：persist.vendor.camera.privapp.list
• Flush/Cancel 流程追踪
• Memory Leak CTS 调试
• 配套图表：CTS 测试框架图、Flush 流程时序图

第 25 章：常见问题实战排查

• ISP Overflow 分析与解决
• Face AEC 振荡问题
• Memory Leak 排查
• 帧率不稳/跳帧
• 黑屏/花屏/偏色
• 功耗异常
• 配套图表：问题排查决策树流程图

---

🌳 第七篇：实战定制与扩展（第 26~28 章）

面向 OEM/ISV 工程师，掌握定制化开发能力

第 26 章：Feature 定制与扩展

• 新增 Feature Descriptor / Instance
• Feature Graph 配置与 Selector
• 新增 Pipeline / Feature Graph
• 参考：高通 Feature2 KBA 系列文档

第 27 章：第三方算法集成

• CHI External Node 接口
• External Node 生命周期管理
• Buffer/IPC 通信机制
• 案例：第三方 EIS / HDR 算法集成
• SAT 多摄算法集成
• 配套图表：External Node 架构图、集成流程图

第 28 章：多摄与前沿技术

• Dual Camera / Triple Camera 架构
• Bokeh 虚化原理
• Remosaic / QCFA：Quadra CFA binning/remosaic 模式切换 ⭐
• HDR 算法：MFHDR / SHDR
• MFNR 多帧降噪
• SuperNight / SuperResolution
• 配套图表：多摄架构图、Remosaic Pipeline 拓扑对比图、HDR Pipeline 图

---