3. HAL测试基础：测试目的、类型与环境搭建

HAL（Hardware Abstraction Layer）测试是Camera HAL开发流程中承上启下的关键环节。它既验证了底层驱动与HAL接口的正确性，又为上层Framework和应用的稳定运行提供了保障。本章将系统阐述HAL测试的核心目的、三大测试类型及其适用场景，并详细讲解测试环境的搭建步骤与常见问题。

3.1 HAL测试的目的

HAL测试的核心目标可以归纳为以下四点：

1. 验证接口契约：确保HAL实现严格遵循Android CDD（兼容性定义文档）和HIDL/AIDL接口规范，包括函数返回值、回调时序、参数范围等。
2. 发现平台耦合缺陷：暴露HAL代码中与特定SoC、ISP、Sensor或驱动强相关的逻辑错误，例如帧率不稳定、3A算法异常、格式转换错误。
3. 保障多Camera兼容性：在多摄像头（广角、长焦、ToF、深度）共存的设备上，验证HAL能否正确管理Camera ID、同步流配置、处理并发请求。
4. 建立回归基线：为后续HAL版本升级、驱动更新或平台迁移提供可重复的自动化测试用例，防止已有功能退化。

3.2 HAL测试类型

根据测试粒度和验证目标，HAL测试通常分为三类：单元测试、集成测试和兼容性测试。下表从多个维度对比了它们的差异：

3.2.1 单元测试

单元测试聚焦于HAL内部每个函数的独立行为。例如，测试camera3_device_t::process_capture_request在传入非法camera3_capture_request_t时是否返回-EINVAL，或测试configure_streams在流格式不匹配时是否正确拒绝配置。

// 单元测试示例：验证 configure_streams 对无效分辨率的处理
TEST(CameraHALUnitTest, ConfigureStreams_InvalidResolution_ReturnsError) {
    camera3_device_t *device = open_test_device();
    camera3_stream_configuration_t config;
    camera3_stream_t stream;
    stream.width = 0;      // 非法宽度
    stream.height = 480;
    stream.format = HAL_PIXEL_FORMAT_YCbCr_420_888;
    config.num_streams = 1;
    config.streams = &stream;

    int32_t result = device->ops->configure_streams(device, &config);
    EXPECT_EQ(result, -EINVAL);
    close_test_device(device);
}

3.2.2 集成测试

集成测试验证HAL与Android Camera Framework、底层驱动之间的协作。典型场景包括：

• 流配置与预览：从Framework下发configure_streams到HAL，再到驱动初始化Sensor和ISP，最终输出预览帧。
• 拍照与ZSL：验证零快门延迟（ZSL）模式下，HAL能否正确管理内部环形缓冲区，并在捕获请求时返回正确帧。
• 多Camera并发：同时打开主摄和广角，验证HAL能否独立管理两个Camera pipeline，不出现资源冲突或帧数据错乱。

集成测试通常通过adb shell执行自定义测试程序，或使用Android原生camera2测试应用。以下是一个典型的集成测试流程：

# 集成测试执行步骤（adb shell）
# 1. 推送测试程序到设备
adb push hal_integration_test /data/local/tmp/
adb shell chmod +x /data/local/tmp/hal_integration_test

# 2. 执行测试（以Camera ID 0为例）
adb shell /data/local/tmp/hal_integration_test --camera_id 0 --test_mode preview_capture

# 3. 查看测试日志
adb logcat -s CameraHALTest:I

3.2.3 兼容性测试

兼容性测试是HAL测试的最终关卡，通常使用Android官方CTS（Compatibility Test Suite）和VTS（Vendor Test Suite）执行。VTS直接测试HAL接口的合规性，CTS则从Framework层间接验证HAL行为。

兼容性测试覆盖的关键点包括：

• Camera ID枚举：确保getCameraIdList返回的ID与物理Camera一一对应，且逻辑Camera（如多摄融合）的ID符合CDD要求。
• 能力查询：验证getCameraCharacteristics返回的ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL、ANDROID_SENSOR_INFO_PIXEL_ARRAY_SIZE等字段与实际硬件一致。
• 流格式支持：检查HAL声明的输出格式（如YUV_420_888、JPEG、RAW10）是否都能在真实设备上正常输出。
• 3A稳定性：在多种光照条件下，验证自动曝光（AE）、自动对焦（AF）、自动白平衡（AWB）的收敛速度和稳定性。

3.3 测试环境搭建

一个稳定、可复现的测试环境是HAL测试的基础。本节介绍三个核心要素：ADB工具链、root权限获取和测试设备选型。

3.3.1 ADB（Android Debug Bridge）

ADB是连接Host PC与Android设备的桥梁。HAL测试中ADB的主要用途包括：

• 推送测试程序和测试数据到设备。
• 执行测试命令并捕获输出。
• 实时查看logcat日志，定位HAL层错误。
• 通过adb forward/adb reverse建立网络隧道，用于远程调试。

以下是一个ADB环境验证的快速检查清单：

3.3.2 root权限

HAL测试通常需要root权限来执行以下操作：

• 访问/dev/video*、/dev/media*等设备节点。
• 修改系统属性（如persist.camera.HAL3.enabled）。
• 加载/卸载内核驱动模块。
• 执行需要CAP_SYS_ADMIN权限的测试（如直接操作ISP寄存器）。

获取root权限的常见方法：

1. 工程固件（Eng Build）：使用adb root命令直接获得root shell。这是最推荐的方式，因为工程固件通常关闭了SELinux强制模式。
2. Userdebug固件：通过adb root或adb shell su获取root。部分设备需要先执行adb disable-verity并重启。
3. 第三方root工具：如Magisk、SuperSU。注意：这可能会破坏设备的安全状态，仅用于开发板或专用测试设备。

3.3.3 测试设备选型

选择测试设备时，应综合考虑以下因素：

3.3.4 环境搭建流程总览

下图展示了从Host PC到测试设备的完整环境搭建流程：

3.3.5 环境验证脚本

完成环境搭建后，建议运行以下快速验证脚本，确保所有组件正常工作：

#!/bin/bash
# HAL测试环境快速验证脚本
# 用法：./check_hal_env.sh

echo "=== 1. 检查ADB设备 ==="
adb devices | grep -q "device$"
if [ $? -eq 0 ]; then
    echo "[PASS] ADB设备已连接"
else
    echo "[FAIL] 未检测到ADB设备"
    exit 1
fi

echo "=== 2. 检查root权限 ==="
adb shell "id | grep -q uid=0"
if [ $? -eq 0 ]; then
    echo "[PASS] 已获得root权限"
else
    echo "[WARN] 未获得root权限，部分测试可能受限"
fi

echo "=== 3. 检查Camera HAL接口 ==="
adb shell "lshal | grep -q android.hardware.camera.provider"
if [ $? -eq 0 ]; then
    echo "[PASS] Camera HAL接口已注册"
else
    echo "[FAIL] Camera HAL接口未注册"
    exit 1
fi

echo "=== 4. 检查Camera设备节点 ==="
adb shell "ls /dev/video* 2>/dev/null | head -5"
if [ $? -eq 0 ]; then
    echo "[PASS] 视频设备节点可访问"
else
    echo "[FAIL] 无法访问视频设备节点"
fi

echo "=== 环境验证完成 ==="

3.4 本章小结