2. 黑屏问题根因分类：Sensor初始化失败、MIPI信号异常、ISP配置错误、Tuning参数丢失

Camera 黑屏（Black Screen）是 HAL 层最棘手的故障之一，表现为预览无画面、拍照全黑或录像无数据。根因可归纳为四大类：Sensor 初始化失败、MIPI 信号异常、ISP 配置错误、Tuning 参数丢失。本章逐一拆解每类的触发条件、排查路径与工程修复手段。

2.1 Sensor 初始化失败

Sensor 初始化是 Camera 上电后的第一道关卡。HAL 层通过 I²C 总线向 Sensor 写入寄存器序列（Init Sequence），若任一关键寄存器写入失败，Sensor 将无法输出有效图像数据，直接导致黑屏。

常见失败场景

• 电源时序不满足：AVDD、DVDD、IOVDD 上电顺序或稳定时间不符合 Sensor 规格书要求。
• I²C 通信异常：总线被拉死、地址错误、时钟延展超时、ACK 丢失。
• 复位信号异常：XSHUTDOWN 或 RESET 引脚电平未正确拉高/拉低。
• MCLK 缺失：主时钟未提供或频率偏差超过 ±1%。

2.2 MIPI 信号异常

MIPI CSI-2 是 Sensor 与 ISP 之间的高速串行数据通道。即使 Sensor 初始化成功，若 MIPI 物理层或协议层异常，ISP 无法接收有效图像数据，同样表现为黑屏。

典型异常类型

• Lane 极性反接：DP/DN 在 PCB 走线或 FPC 连接器中反接。
• 时钟抖动过大：MIPI 时钟的周期抖动 > 0.2 UI，导致接收端 PLL 失锁。
• 电压不匹配：Sensor 输出共模电压与 ISP 接收端不匹配（如 200mV vs 150mV）。
• Lane 数配置错误：HAL 配置 4-lane 但实际硬件只连接 2-lane。

2.3 ISP 配置错误

ISP（Image Signal Processor）配置错误通常发生在 HAL 层向 ISP 驱动下发 Pipeline 参数时。错误的配置会导致 ISP 内部处理路径断裂，输出全黑或无效数据。

常见配置错误

• 输入格式不匹配：Sensor 输出 RAW10，ISP 配置为 RAW8，导致数据截断。
• 时钟分频错误：ISP 核心时钟或 AXI 总线时钟过低，无法处理预期帧率。
• Pipeline 拓扑错误：ISP 内部模块（BLC、AWB、Demosaic）连接顺序或使能状态错误。
• 输出尺寸/裁剪错误：Target size 超过 ISP 最大处理能力，或裁剪窗口全黑。

// 示例：HAL 层 ISP 配置 dump 片段
struct isp_config {
    .input_format    = ISP_FMT_RAW10,      // 期望 RAW10
    .input_width     = 1920,
    .input_height    = 1080,
    .mipi_lanes      = 4,
    .pixel_clock_hz  = 480000000,          // 480 MHz
    .pipeline_mask   = (1 << ISP_BLC) | (1 << ISP_AWB) | (1 << ISP_DEMOSAIC),
    .output_format   = ISP_FMT_NV12,
    .output_width    = 1920,
    .output_height   = 1080,
};
// 常见错误：pixel_clock_hz 写为 48000000（少一个0），导致 ISP 处理能力不足

2.4 Tuning 参数丢失

Tuning 参数（AWB、AEC、校正矩阵、LSC 等）通常以 XML 或二进制文件形式加载到 ISP。若文件路径错误、格式不兼容或加载时序不对，ISP 将使用默认参数或全零参数，导致图像全黑或严重偏色。

丢失原因

• 文件路径错误：HAL 中硬编码的 tuning 文件路径与实际文件系统不匹配。
• 版本不兼容：tuning 文件版本与 ISP 固件版本不一致，解析失败。
• 加载时序错误：tuning 参数在 ISP 启动后才加载，导致 ISP 使用默认值。
• 文件损坏：OTA 升级或文件系统异常导致 tuning 文件内容不完整。

2.5 四类根因的快速定位矩阵

在实际工程中，黑屏问题往往涉及多个根因交织。下表总结了四类根因的典型现象、HAL log 关键词和快速定位手段，帮助工程师在 5 分钟内锁定方向。