CTS测试故障排查：高通Camera项目兼容性验证案例 - 第1节
1.1 CTS 测试体系概述
兼容性测试套件（Compatibility Test Suite，CTS）是 Google 为 Android 生态打造的官方验证工具集。任何设备若想预装 Google 移动服务（GMS），必须通过 CTS 认证。CTS 的核心目标在于确保同一版本的 Android 系统在不同硬件平台上保持 API 行为一致、应用兼容性达标。
关键认知： CTS 不是性能测试工具，而是接口契约验证工具。它检查的是“系统是否按 AOSP 规范实现了 API”，而非“跑得快不快”。
1.1.1 CTS 测试层级与执行流程
CTS 测试覆盖从底层 HAL 到上层 Framework 的完整链路。其执行流程可概括为三个阶段：
- 测试调度（Tradefed）： 通过 Trade Federation 框架下发测试模块，管理设备连接与用例分发。
- 用例执行（Instrumentation）： 每个测试用例以 Android Instrumentation 方式运行，调用被测 API 并捕获结果。
- 结果收集与报告： 生成 XML 格式的 test_result.xml，包含每个用例的 pass/fail/ignore 状态及失败堆栈。
1.1.2 CTS 与 CTS Verifier 的区别
| 对比维度 | CTS | CTS Verifier |
|---|---|---|
| 执行方式 | 全自动，通过命令行或 Tradefed 运行 | 半自动，需要人工操作设备界面 |
| 覆盖范围 | API 兼容性、行为一致性、安全模型 | 传感器、相机预览、NFC、GPS 等需人眼判断的场景 |
| 结果判定 | 程序自动判定 pass/fail | 测试员手动点击 pass/fail |
| Camera 相关 | android.hardware.camera2.* 单元测试 | 预览画质、对焦准确性、闪光灯同步等主观项 |
1.2 Camera CTS 子集分类
Camera 模块在 CTS 中拥有独立的测试子集，主要分布在 android.hardware.camera2 和 android.hardware.camera 包下。根据测试对象和验证目标，可划分为以下四大类：
1.2.1 基础功能测试（CameraBase）
- CameraManagerTest： 验证
CameraManager能否正确枚举摄像头、获取CameraCharacteristics。 - CameraDeviceTest： 测试打开/关闭 CameraDevice、创建 CaptureSession 等基本生命周期。
- CameraMetadataTest： 检查静态元数据（如
INFO_SUPPORTED_HARDWARE_LEVEL）是否合规。
1.2.2 图像捕获与参数测试（CameraCapture）
- CaptureRequestTest： 验证不同 CaptureRequest 参数（AE/AF/AWB、帧率、输出尺寸）是否生效。
- StillCaptureTest： 测试 JPEG/YUV 拍照、RAW 输出、Burst 模式。
- VideoCaptureTest： 验证录像启动/停止、帧率稳定性、音视频同步。
1.2.3 扩展特性测试（CameraExtension）
- HDR+ / Night Mode： 检查多帧合成、长曝光等扩展模式是否返回正确结果。
- Logical Camera： 验证多摄（广角+长焦）切换、景深数据流。
- Session Parameter： 测试
SessionConfiguration中动态参数更新。
1.2.4 性能与压力测试（CameraStress）
- CameraOpenCloseTest： 反复打开/关闭摄像头，检测内存泄漏和句柄泄漏。
- ConcurrentCameraTest： 验证前后摄同时打开、多路流并发。
- CameraLatencyTest： 测量从按下快门到图像回调的延迟。
1.3 高通平台 Camera 架构概览
高通平台 Camera 软件栈采用分层设计，从上到下依次为：应用层 → Framework → Camera HAL → 内核驱动。理解这一架构对于 CTS 故障排查至关重要，因为失败可能发生在任意一层。
1.3.1 高通 Camera 软件栈分层
| 层级 | 组件 | 职责 | CTS 故障常见表现 |
|---|---|---|---|
| 应用层 | Camera App / CTS Test App | 发起拍照/录像请求，展示预览 | 测试用例超时、ANR |
| Framework | android.hardware.camera2 | API 封装、权限管理、流配置 | IllegalArgumentException、UnsupportedOperationException |
| Camera HAL | Qualcomm Camera HAL (mm-camera) | 实现 Camera 3.x 接口，管理 ISP、传感器、算法 | metadata 缺失、buffer 错误、3A 失败 |
| 内核驱动 | V4L2 + Sensor/ISP 驱动 | 硬件寄存器操作、中断处理、DMA 传输 | ioctl 错误、DMA 超时、电源管理异常 |
1.3.2 高通 Camera HAL 核心模块
高通 Camera HAL 基于 mm-camera 架构，主要包含以下核心模块：
- Camera Daemon (mm-qcamera-daemon)： 用户空间守护进程，负责与 HAL 层通信，管理摄像头生命周期。
- ISP (Image Signal Processor)： 硬件图像处理单元，处理 Bayer 数据、降噪、色彩校正、HDR 合成。
- Sensor Driver： 直接控制图像传感器（Sony/OV/Samsung 等），配置曝光、增益、帧率。
- 3A (AE/AF/AWB)： 自动曝光、自动对焦、自动白平衡算法模块，通常运行在 DSP 或 CPU 上。
- Post-processing： 包括 JPEG 编码、视频编码、人脸检测、美颜等扩展功能。
1.3.3 高通 Camera 数据流路径
一次典型的拍照请求，数据流经过以下路径：
- App 发起 CaptureRequest： 指定输出目标（Surface）、参数（AE/AF/AWB 模式）。
- Framework 构建请求： 将 CaptureRequest 转换为 HAL 可识别的
camera3_capture_request_t。 - HAL 处理请求： mm-camera 将请求拆分为 ISP 配置、Sensor 配置、3A 计算。
- Sensor 曝光输出： 驱动控制传感器曝光，输出 RAW10/RAW12 数据到 ISP。
- ISP 处理： 执行黑电平校正、去马赛克、降噪、色彩校正，输出 YUV 或 JPEG。
- Buffer 返回： 处理后的图像数据通过 HAL 返回给 Framework，最终交付给 App 的 Surface。
实战提示： 在 CTS 故障排查中，
dumpsys media.camera 和 logcat -s mm-camera 是最常用的诊断命令。前者可查看摄像头状态和流配置，后者可追踪 HAL 内部处理细节。
1.3.4 高通平台 CTS 常见失败模式
| 失败模式 | 典型错误日志 | 根因层级 | 排查方向 |
|---|---|---|---|
| Metadata 缺失 | android.control.aeMode not supported | HAL | 检查 CameraCharacteristics 静态元数据配置 |
| Buffer 超时 | dequeueBuffer timed out | HAL / 内核 | 检查 ISP 处理延迟、DMA 传输带宽 |
| 3A 收敛失败 | AE convergence timeout | HAL | 检查传感器驱动、3A 算法参数 |
| 流配置不兼容 | Stream configuration failed | HAL | 检查支持的输出尺寸、格式组合 |
| 权限拒绝 | CameraService: Permission Denial | Framework | 检查 SELinux 策略、权限声明 |
注意： 高通平台 Camera HAL 存在多个版本（如 CAMX、mm-camera 旧版），不同版本对 CTS 的支持程度不同。在排查前，务必确认当前平台使用的 HAL 版本及对应的 patch 基线。