📚 课程目录第4章常见故障分类

4. 常见故障分类：Camera CTS失败类型概览、硬件兼容性、HAL实现、权限问题

在高通Camera项目的CTS兼容性验证中，故障类型通常可以归纳为四大类：硬件兼容性、HAL实现、权限问题以及框架/应用层。理解这些分类有助于快速定位问题根因，避免在调试过程中走弯路。

经验法则： 约70%的Camera CTS失败与HAL层实现直接相关，15%源于硬件兼容性，10%为权限配置遗漏，剩余5%为测试环境或框架Bug。

4.1 故障分类总览

下表列出了Camera CTS失败的主要分类、典型表现及常见根因，便于测试工程师在分析日志时快速归类。

故障分类	典型CTS测试项	失败表现	常见根因
硬件兼容性	TestCameraCharacteristics, TestPreviewSize	支持的尺寸/格式与报告不一致；Sensor无法输出指定帧率	Sensor模组驱动未适配；MIPI/CSI接口时序异常；EEPROM校准数据缺失
HAL实现	TestCaptureRequest, Test3A, TestYuvReprocess	Capture结果超时；AE/AWB收敛失败；YUV重处理返回空buffer	HAL未正确实现metadata回调；Pipeline状态机异常；Tuning参数未生效
权限问题	TestCameraPermission, TestMultipleSessions	权限拒绝异常；多进程同时打开Camera失败	AndroidManifest未声明权限；SELinux策略限制；Provider权限未配置
框架/应用层	TestCamera2Basic, TestSystemCamera	预览黑屏；拍照无回调；系统相机闪退	Framework API版本不匹配；App未适配Camera2特性；资源竞争死锁

  分类优先级： 建议按照“硬件兼容性 → HAL实现 → 权限问题 → 框架/应用层”的顺序排查。硬件基础不满足时，上层HAL和框架的调试将失去意义。

4.2 硬件兼容性故障

硬件兼容性故障是CTS验证中最基础也最容易被忽视的一类。高通平台Camera硬件链路涉及Sensor、VCM（音圈马达）、EEPROM、闪光灯等多个器件，任何一环的兼容性缺失都会导致CTS失败。

典型场景包括：

Sensor ID不匹配： 驱动中Sensor ID与硬件实际ID不一致，导致Camera HAL无法枚举到设备。
MIPI Lane配置错误： 数据通道数或速率与Sensor输出不匹配，导致预览花屏或帧率异常。
EEPROM数据损坏： 校准数据（AF位置、AWB增益）读取失败，导致3A算法无法收敛。
Flash驱动时序： 闪光灯电流或时序未按高通参考设计配置，导致Torch模式CTS失败。

4.3 HAL实现故障

HAL（Hardware Abstraction Layer）是Camera CTS失败的重灾区。高通Camera HAL需要实现从Camera ID枚举、Stream配置到Capture请求处理的完整流程，任何环节的遗漏或错误都会导致测试失败。

常见HAL实现故障包括：

Metadata未正确填充： 如android.sensor.info.sensitivityRange未设置，导致TestCameraCharacteristics失败。
Pipeline状态机异常： 在configure_streams后未正确进入IDLE状态，导致后续request被拒绝。
Buffer管理错误： 未在指定超时时间内返回Capture结果，触发CAMERA3_CAPTURE_RESULT_TIMEOUT。
3A算法未收敛： AE/AWB/AF未在预期帧数内稳定，导致Test3A测试项失败。

关键调试点： 在HAL的process_capture_request入口和出口添加日志，记录request ID和返回的metadata数量。对比CTS期望的metadata集合，快速定位缺失项。

以下是一个典型的HAL实现中metadata填充的代码片段：

// HAL实现中填充android.sensor.info.sensitivityRange
camera_metadata_entry_t entry;
if (find_camera_metadata_entry(metadata, 
        ANDROID_SENSOR_INFO_SENSITIVITY_RANGE, &entry) == 0) {
    // 已存在，更新值
    int32_t range[2] = {100, 3200};
    update_camera_metadata_entry(metadata, entry.index, 
                                 range, 2, NULL);
} else {
    // 不存在，新增
    int32_t range[2] = {100, 3200};
    add_camera_metadata_entry(metadata, 
        ANDROID_SENSOR_INFO_SENSITIVITY_RANGE, 
        range, 2);
}

4.4 权限问题

权限问题虽然占比不高，但一旦出现往往会导致整组CTS测试项失败，影响测试效率。Camera CTS涉及的权限包括Android应用层权限、系统级权限以及SELinux安全策略。

权限问题的主要表现：

应用层权限缺失： 测试APK未声明android.permission.CAMERA，导致SecurityException。
Provider权限未配置： 多Camera场景下，Provider未正确配置android:permission属性，导致跨进程访问失败。
SELinux策略限制： HAL进程无法访问/dev/video*节点或/sys/class/camera节点，导致设备枚举失败。
运行时权限未授予： CTS测试框架在Android 6.0+需要动态授予权限，若测试环境未正确授权则失败。

  SELinux调试技巧： 使用adb shell dmesg | grep avc查看被拒绝的权限日志，将对应的denial信息添加到external/sepolicy或device/qcom/sepolicy中的对应.te文件。例如：allow hal_camera_default video_device:chr_file rw_file_perms;

4.5 故障分类与排查优先级

在实际项目中，建议按照以下优先级进行故障排查：

硬件兼容性： 确认Sensor、MIPI、EEPROM等基础硬件链路正常。
HAL实现： 检查metadata填充、Pipeline状态、Buffer管理是否符合CTS要求。
权限问题： 验证应用权限、Provider权限、SELinux策略是否配置完整。
框架/应用层： 确认测试APK版本、Framework API兼容性、资源竞争情况。

通过系统化的故障分类和优先级排序，可以显著提升CTS调试效率，避免在非关键问题上消耗过多时间。