2. HAL层移植环境搭建：配置高通Camera开发环境

HAL层移植的第一步是构建一个完整、可复现的开发环境。高通Camera子系统的开发环境涉及交叉编译工具链、内核头文件、平台SDK以及调试通道四个核心维度。本章将逐一拆解每个组件的配置要点，并提供环境验证方法。

2.1 交叉编译工具链配置

高通Camera HAL模块必须使用与目标内核匹配的交叉编译器进行编译。推荐使用高通官方提供的GCC ARM64工具链（aarch64-linux-android- 或 aarch64-linux-gnu-）。

# 以aarch64-linux-gnu-工具链为例，解压并设置环境变量
wget https://developer.arm.com/-/media/Files/downloads/gnu/12.2.rel1/binrel/arm-gnu-toolchain-12.2.rel1-x86_64-aarch64-none-linux-gnu.tar.xz
sudo tar -xf arm-gnu-toolchain-12.2.rel1-x86_64-aarch64-none-linux-gnu.tar.xz -C /opt/
export PATH=/opt/arm-gnu-toolchain-12.2.rel1-x86_64-aarch64-none-linux-gnu/bin:$PATH

# 验证工具链
aarch64-none-linux-gnu-gcc --version
# 输出应包含 "aarch64-none-linux-gnu-gcc (GNU Toolchain for the A-profile Architecture) 12.2.rel1"

2.2 内核头文件与Kernel API对齐

Camera HAL层通过V4L2、ION/DMA-BUF、Media Controller等内核接口与驱动交互。编译HAL时必须包含目标平台的内核头文件，确保结构体定义、ioctl号、枚举值一致。

# 从高通BSP包中提取内核头文件
# 假设BSP解压路径为 ~/qcom_la.um.8.6_r1
KERNEL_SRC=~/qcom_la.um.8.6_r1/kernel_platform
HEADER_DEST=/opt/qcom/kernel-headers/qcm6490

mkdir -p $HEADER_DEST
# 复制用户态可见的头文件
cp -r $KERNEL_SRC/msm-kernel/include/uapi $HEADER_DEST/
cp -r $KERNEL_SRC/msm-kernel/include/linux $HEADER_DEST/
# 高通Camera专用头文件（如cam_sensor.h, cam_req_mgr.h）
cp -r $KERNEL_SRC/msm-kernel/drivers/cam_req_mgr $HEADER_DEST/
cp -r $KERNEL_SRC/msm-kernel/drivers/cam_sensor_module $HEADER_DEST/

# 设置CFLAGS
export CFLAGS="-I/opt/qcom/kernel-headers/qcm6490/uapi -I/opt/qcom/kernel-headers/qcm6490/linux"

2.3 QCM SDK安装与配置

高通QCM（Qualcomm Commercial Module）SDK是Camera HAL移植的核心依赖，包含CHI API头文件、libcamx、libchi HAL实现、以及编译脚本模板。SDK通常以压缩包形式随BSP发布。

# 解压QCM SDK
unzip QCM6490_SDK_LA.UM.10.3.1.zip -d /opt/qcom/qcm_sdk_v2.0

# SDK目录结构
tree -L 2 /opt/qcom/qcm_sdk_v2.0/
/opt/qcom/qcm_sdk_v2.0/
├── CHIApi/                  # CHI API头文件（核心）
│   ├── inc/
│   │   ├── chi_common.h
│   │   ├── chi_metadata.h
│   │   ├── chi_ois.h
│   │   └── chi_isp.h
│   └── lib/
│       ├── libchi_common.so
│       └── libchi_isp.so
├── camx/                    # Camera HAL核心库源码
│   ├── src/
│   ├── include/
│   └── build/
├── oem/                     # OEM定制层（Sensor/Flash/AF适配）
│   ├── sensor/
│   ├── actuator/
│   └── eeprom/
├── tools/                   # 调试与性能工具
│   ├── cam_trace/
│   └── cam_perf/
└── build_scripts/           # CMake / Makefile模板
    ├── android.bp
    └── qcm_hal.mk

2.4 ADB调试环境搭建

ADB（Android Debug Bridge）是HAL层开发中最常用的调试通道，用于推送HAL库、抓取logcat、执行测试用例以及捕获Camera dump数据。

# 安装ADB
sudo apt install adb fastboot

# 配置udev规则（高通QCM6490 VID:PID通常为 18d1:4ee7）
echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", ATTR{idProduct}=="4ee7", MODE="0666", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/51-android.rules
sudo udevadm control --reload-rules
sudo udevadm trigger

# 验证连接
adb devices
# 输出示例：
# List of devices attached
# 1234567890abcdef	device

# 如果目标板没有USB ADB，使用TCP/IP方式
adb connect 192.168.1.100:5555

2.5 环境验证清单

完成上述配置后，执行以下验证步骤，确保环境可用。

1. 工具链验证： 编译一个空的HAL桩文件，确认链接无报错。
2. 内核头文件验证： 检查 linux/cam_sensor.h 中 CAM_SENSOR_PROBE_CMD 宏定义是否存在。
3. SDK完整性验证： 确认 CHIApi/inc/chi_common.h 包含 ChiCreate、ChiDestroy 等核心API声明。
4. ADB连通性验证： 执行 adb shell cat /proc/version 确认内核版本与头文件匹配。
5. Camera设备节点验证： adb shell ls -l /dev/video* 应列出至少3个video节点（ISP、JPEG、Sensor）。

2.6 常见环境问题排查