📚 课程目录第2章 Camera HAL层开发环境搭建

2. Camera HAL层开发环境搭建：交叉编译工具链配置、Android源码树中HAL模块的集成、adb与logcat调试环境准备

嵌入式平台Camera HAL层的开发环境搭建是后续调试与优化的基础。本章围绕三个核心环节展开：交叉编译工具链配置、Android源码树中HAL模块的集成以及adb与logcat调试环境准备。正确搭建这些环境，能够显著减少编译与调试阶段的阻塞时间。

2.1 交叉编译工具链配置

嵌入式平台通常资源受限，无法直接在目标板上进行编译。交叉编译工具链在宿主机（x86_64 Linux）上运行，生成目标架构（如ARM64、ARM32）的可执行文件与动态库。

2.1.1 工具链选择与安装

根据目标芯片厂商（Qualcomm、MTK、Rockchip、Allwinner等）选择对应的工具链。常见选项如下：

工具链类型	适用平台	安装方式
Android NDK (r25+)	通用Android HAL开发	下载NDK包，解压后使用`toolchains/llvm/prebuilt/linux-x86_64/bin/`
Linaro GCC	ARM32/ARM64 Linux	`apt install gcc-aarch64-linux-gnu g++-aarch64-linux-gnu`
芯片厂商SDK自带工具链	特定SoC（如Qualcomm SA系列）	解压厂商提供的交叉编译工具包，设置`PATH`

建议：优先使用Android NDK内置的Clang/LLVM工具链，因为它与Android系统ABI（如64位c++_shared、c++_static）兼容性最好，且支持最新的C++标准。

2.1.2 环境变量与测试

配置工具链的核心是设置CC、CXX、AR、LD等环境变量，并确保sysroot指向目标系统的根文件系统。以下是一个典型的配置脚本片段：

#!/bin/bash
# 以Android NDK r26为例，目标架构aarch64
export NDK_HOME=/opt/android-ndk-r26
export TOOLCHAIN=$NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64
export TARGET=aarch64-linux-android
export API=31

export CC=$TOOLCHAIN/bin/${TARGET}${API}-clang
export CXX=$TOOLCHAIN/bin/${TARGET}${API}-clang++
export AR=$TOOLCHAIN/bin/llvm-ar
export LD=$TOOLCHAIN/bin/ld.lld
export SYSROOT=$TOOLCHAIN/sysroot

# 验证
echo "CC: $CC"
$CC --version

验证工具链是否正常工作：编写一个简单的hello_hal.c，使用上述环境变量编译，然后通过file命令确认生成的是目标架构的ELF文件。

$ aarch64-linux-android31-clang -o hello_hal hello_hal.c
$ file hello_hal
hello_hal: ELF 64-bit LSB executable, ARM aarch64, version 1 (SYSV), dynamically linked, interpreter /system/bin/linker64, not stripped

常见问题：如果编译时提示“cannot find -lc++_shared”或“undefined reference to __cxa_atexit”，通常是因为SYSROOT路径未正确指向NDK的sysroot，或者链接器未找到对应的运行时库。请检查$SYSROOT/usr/lib下是否存在libc++_shared.so。

2.2 Android源码树中HAL模块的集成

Camera HAL模块通常以Android.bp（或Android.mk）的形式集成到Android源码树中。集成过程涉及模块定义、依赖声明、权限配置以及分区挂载。

2.2.1 HAL模块目录结构

一个标准的Camera HAL模块在源码树中的布局如下：

hardware/
└── myplatform/
    └── camera/
        ├── Android.bp
        ├── include/
        │   └── camera_hal.h
        ├── src/
        │   ├── CameraHAL.cpp
        │   ├── CameraDevice.cpp
        │   └── CameraHAL.h
        ├── libs/
        │   └── libcamera_metadata_helper/
        └── tests/
            └── CameraHALTest.cpp

2.2.2 Android.bp 配置示例

使用Android.bp（Blueprint）定义HAL模块，支持静态库、共享库和可执行文件。以下是一个Camera HAL共享库的典型配置：

cc_library_shared {
    name: "camera.myplatform",
    vendor: true,
    relative_install_path: "hw",
    srcs: [
        "src/CameraHAL.cpp",
        "src/CameraDevice.cpp",
    ],
    include_dirs: [
        "include",
        "system/media/camera/include",
    ],
    shared_libs: [
        "libcamera_client",
        "libcamera_metadata",
        "libcutils",
        "libutils",
        "liblog",
        "libhardware",
        "libsync",
    ],
    static_libs: [
        "libcamera_metadata_helper",
    ],
    cflags: [
        "-Wall",
        "-Werror",
        "-O2",
        "-DPLATFORM_SDK_VERSION=$(PLATFORM_SDK_VERSION)",
    ],
    product_variables: {
        debuggable: {
            cflags: ["-DCAMERA_HAL_DEBUG=1"],
        },
    },
}

  关键点：
  vendor: true 表示该模块安装在vendor分区，符合Treble架构要求。
relative_install_path: "hw" 使得最终路径为 /vendor/lib64/hw/camera.myplatform.so。
product_variables.debuggable 允许在userdebug/eng版本中开启调试宏。

2.2.3 集成到系统镜像

在完成Android.bp配置后，需要将模块添加到产品的device.mk或product.mk中：

# device/mycompany/mydevice/device.mk
PRODUCT_PACKAGES += \
    camera.myplatform \
    libcamera_metadata_helper

然后执行完整编译或单模块编译：

source build/envsetup.sh
lunch mydevice-userdebug
make camera.myplatform -j$(nproc)

编译成功后，生成的camera.myplatform.so位于out/target/product/mydevice/vendor/lib64/hw/。

2.2.4 集成流程总览

下图展示了从源码编写到系统镜像烧录的完整集成流程：

2.3 adb与logcat调试环境准备

adb（Android Debug Bridge）和logcat是Camera HAL开发中最常用的调试工具。正确配置这两个工具，能够实现高效的日志采集、问题定位和快速验证。

2.3.1 adb环境配置

adb工具包含在Android SDK Platform-Tools中。配置步骤如下：

下载Platform-Tools：从官方渠道获取适用于Linux的压缩包。
解压并加入PATH：

unzip platform-tools-latest-linux.zip -d ~/android
export PATH=$PATH:~/android/platform-tools
# 建议将上述export写入 ~/.bashrc 或 ~/.zshrc

验证连接：

adb devices
# 输出示例：
# List of devices attached
# 0123456789ABCDEF    device

权限问题：如果adb devices显示unauthorized，请在目标板上确认USB调试授权。如果显示no permissions，请将用户加入plugdev组或使用sudo adb kill-server; sudo adb start-server。

2.3.2 logcat调试配置

logcat是Android的日志系统。Camera HAL通常使用ALOGV、ALOGD、ALOGE等宏输出日志。调试时建议按以下方式过滤：

# 实时查看Camera HAL相关日志（tag包含camera或CamHAL）
adb logcat -v threadtime | grep -E "camera|CamHAL|CameraService"

# 将日志保存到文件，便于后续分析
adb logcat -v threadtime -d > camera_hal_log.txt

# 清除旧日志，重新开始采集
adb logcat -c

在HAL代码中，建议使用统一的日志标签，例如：

#define CAMHAL_LOG_TAG "CamHAL_MyPlatform"
#define ALOGD(...) __android_log_print(ANDROID_LOG_DEBUG, CAMHAL_LOG_TAG, __VA_ARGS__)
#define ALOGE(...) __android_log_print(ANDROID_LOG_ERROR, CAMHAL_LOG_TAG, __VA_ARGS__)

2.3.3 调试环境架构

下图展示了宿主机与目标板之间的调试链路：

2.3.4 调试技巧与常见问题

场景	命令/方法	说明
查看HAL加载是否成功	`adb shell dmesg \| grep camera`	检查内核日志中是否有camera相关设备注册信息
确认HAL模块版本	`adb shell lshal \| grep camera`	列出所有注册的HAL服务，确认camera provider是否运行
实时跟踪HAL调用	`adb logcat -s CamHAL_MyPlatform`	只显示指定tag的日志，减少干扰
抓取ANR或crash栈	`adb logcat -b crash`	查看native crash日志，定位HAL层崩溃原因
性能分析（帧率/延迟）	`adb shell dumpsys media.camera`	获取CameraService内部状态，包括流配置、帧率统计

避坑提示：

如果adb logcat输出为空，请检查目标板是否处于user版本（user版本默认关闭logd）。建议使用userdebug或eng版本进行开发调试。
在HAL代码中大量使用ALOGV（verbose）会导致日志洪流，影响性能。建议在调试版本中通过编译宏控制verbose日志的开关。
使用adb root获取root权限后，可以访问/vendor/lib64/hw/目录，直接替换HAL .so文件进行快速验证，无需完整烧录镜像。

2.4 环境验证清单

完成上述配置后，建议按照以下清单逐项验证，确保环境就绪：

交叉编译验证：编译一个简单的C程序，确认生成目标架构的可执行文件。
单模块编译验证：执行make camera.myplatform，确认编译无错误，输出路径正确。
adb连接验证：adb devices显示设备状态为device。
logcat输出验证：adb logcat -s CamHAL_MyPlatform能够实时显示HAL日志。
HAL模块加载验证：adb shell lshal | grep camera显示对应的camera provider服务。