4. 工具链准备：Systrace/Perfetto配置、adb shell命令、dumpsys media.camera、logcat过滤技巧

在开始定位 HAL1 Camera HAL 层性能瓶颈之前，必须搭建一套高效、精准的调试工具链。本章将详细介绍四大核心工具：Systrace/Perfetto（系统级跟踪）、adb shell 命令（实时探查）、dumpsys media.camera（框架状态快照）以及 logcat 过滤技巧（日志定向捕获）。掌握这些工具的正确配置与使用，是后续瓶颈定位的基础。

4.1 Systrace/Perfetto 配置与使用

Systrace（Android 9 及以下）和 Perfetto（Android 10+ 推荐）是分析 Camera 管道中 CPU 调度、Binder 通信、SurfaceFlinger 合成等时序问题的核心工具。对于 HAL1 Camera，重点关注 CameraService、HAL、SurfaceFlinger 三个进程的跟踪数据。

4.1.1 Systrace 配置要点

4.1.2 Perfetto 配置与启动

Perfetto 提供了更精细的跟踪能力，支持 自定义数据源 和 长时间跟踪。对于 HAL1 Camera 性能分析，推荐使用以下配置：

# perfetto_config.pbtx 配置文件内容
buffers: {
    size_kb: 8192
    fill_policy: DISCARD
}
data_sources: {
    config {
        name: "linux.ftrace"
        ftrace_config {
            ftrace_events: "sched/sched_switch"
            ftrace_events: "power/cpu_frequency"
            ftrace_events: "binder/binder_transaction"
            ftrace_events: "binder/binder_transaction_received"
            ftrace_events: "camera/*"
        }
    }
}
data_sources: {
    config {
        name: "android.atrace"
        atrace_config {
            categories: "hal"
            categories: "camera"
            categories: "gfx"
            categories: "input"
        }
    }
}
duration_ms: 10000

启动跟踪命令：

# 推送配置文件到设备
adb push perfetto_config.pbtx /data/local/tmp/

# 启动 Perfetto 跟踪
adb shell perfetto -c /data/local/tmp/perfetto_config.pbtx -o /data/local/tmp/trace.perfetto-trace

# 执行 Camera 操作（预览/拍照/录像）

# 停止跟踪（Ctrl+C 或等待 duration_ms 结束）

# 拉取跟踪文件
adb pull /data/local/tmp/trace.perfetto-trace .

4.2 adb shell 命令：实时探查 HAL 状态

adb shell 是连接 Android 设备与调试主机的桥梁。在 HAL1 Camera 性能分析中，以下命令组合可以快速获取设备实时状态：

4.2.1 核心命令清单

4.2.2 实战组合命令

# 1. 获取 CameraService 和 HAL 进程 PID
adb shell ps -A | grep -E "cameraserver|android.hardware.camera"

# 2. 实时监控 HAL 线程 CPU 占用（假设 PID 为 1234）
adb shell top -H -p 1234 -d 1 -n 10

# 3. 查看 HAL 线程调度统计
adb shell cat /proc/1234/task/*/schedstat

# 4. 检查 ION 内存（确认缓冲区分配）
adb shell cat /d/ion/heaps/system | grep -E "camera|alloc"

# 5. 查看 HAL 主线程内核栈（判断是否阻塞）
adb shell cat /proc/1234/task/<tid>/stack

4.3 dumpsys media.camera：框架状态快照

dumpsys media.camera 是 Android Camera 框架提供的内部状态转储工具，可以获取 CameraService、HAL 客户端、流配置、缓冲区状态 等关键信息。对于 HAL1 设备，该命令能暴露 HAL 层的配置参数和运行时状态。

4.3.1 常用子命令

4.3.2 关键输出字段解读

# 示例输出片段（HAL1 设备）
Camera 0 (back) - HAL1:
  Status: ACTIVE
  Client: com.example.camera (pid 1234)
  Streams:
    Stream 0: 1920x1080, format=NV21, usage=SW_READ_OFTEN
      Buffer count: 8, free buffers: 2
      Last frame timestamp: 1234567890 (ns)
  HAL call stats:
    preview_stream_ops::dequeue_buffer: 120 calls, avg 3.2ms
    preview_stream_ops::enqueue_buffer: 118 calls, avg 0.8ms
    camera_device::preview_stream_ops: 2 calls, avg 15.1ms

4.4 logcat 过滤技巧：精准捕获 HAL 层日志

logcat 是 Android 日志系统的核心工具。在 HAL1 Camera 调试中，需要从海量日志中快速筛选出与 Camera HAL 相关的信息。以下过滤技巧可以大幅提升效率。

4.4.1 标签与优先级过滤

4.4.2 时间戳与缓冲区控制

# 显示带精确时间戳的日志（毫秒级）
adb logcat -v time -s CameraService HAL

# 显示带线程 ID 的日志（便于关联线程）
adb logcat -v threadtime -s CameraService HAL

# 清空旧日志后开始捕获（避免干扰）
adb logcat -c && adb logcat -v time -s CameraService HAL

# 将日志输出到文件（便于后续分析）
adb logcat -v time -s CameraService HAL > camera_hal.log

4.4.3 HAL1 专用日志过滤脚本

#!/system/bin/sh
# hal1_log_filter.sh - 在设备端运行
# 用途：实时过滤 HAL1 Camera 相关日志

LOG_TAGS="CameraService:HAL:cameraserver:libcamera"
PRIORITY="*:V"

# 启动过滤日志，输出到 /data/local/tmp/hal1_trace.log
logcat -v threadtime -s $LOG_TAGS $PRIORITY -f /data/local/tmp/hal1_trace.log &

# 同时输出到控制台（便于实时观察）
logcat -v threadtime -s $LOG_TAGS $PRIORITY

4.5 工具链组合使用策略

在实际性能分析中，单一工具往往无法完整呈现问题全貌。以下表格总结了四种工具的典型组合场景：