2. logcat 基础：命令详解、日志级别与缓冲区概念

在 Camera HAL 调试中，logcat 是获取运行时信息最直接的工具。理解其命令参数、日志级别划分以及缓冲区机制，是高效定位 HAL 层问题的前提。本节将系统讲解 logcat 的核心概念与实战用法。

2.1 logcat 命令详解

logcat 是 Android 提供的命令行日志工具，用于实时查看系统日志输出。以下为 Camera HAL 调试中最常用的命令选项：

2.2 日志级别（Log Level）

Android 日志系统定义了 6 个级别，从低到高依次为：Verbose、Debug、Info、Warning、Error、Fatal。每个级别代表不同的严重程度和调试价值。

下图展示了日志级别在 Camera HAL 调试中的典型过滤策略：

2.3 日志缓冲区（Buffer）概念

Android 日志系统将不同来源的日志写入不同的环形缓冲区。理解缓冲区结构有助于在 Camera HAL 调试中快速定位日志来源。

2.3.1 主要缓冲区类型

2.3.2 缓冲区工作机制

每个缓冲区是固定大小的环形结构，当写满时会覆盖最旧的日志。缓冲区大小因设备而异，通常在 64KB~256KB 之间。下图展示了环形缓冲区的工作流程：

2.4 实战：Camera HAL 日志抓取组合命令

以下是在 Camera HAL 调试中常用的 logcat 命令组合：

# 1. 全量抓取 Camera HAL 日志（推荐）
adb logcat -v threadtime -b all -s CameraHal:* > camera_hal_full.log

# 2. 只抓取 Error 及以上级别
adb logcat -v threadtime -b system CameraHal:E *:S

# 3. 抓取特定进程的日志
adb logcat --pid=$(adb shell pidof cameraserver) -v threadtime

# 4. 抓取崩溃日志
adb logcat -b crash -d > crash_log.txt

# 5. 实时过滤并输出到文件
adb logcat -v threadtime -b all | grep -E "CameraHal|CameraService" > camera_filter.log

2.5 常见问题与避坑指南

• 问题：使用 -b main 抓不到 HAL 日志
  原因：HAL 层日志写入 system 缓冲区
  解决：改用 -b system 或 -b all
• 问题：日志被截断，看不到完整信息
  原因：logcat 默认每行 4KB 限制
  解决：使用 --print-long 参数
• 问题：抓取过程中日志丢失
  原因：环形缓冲区溢出，旧日志被覆盖
  解决：增加缓冲区大小（需 root）：adb shell logcat -G 1MB
• 问题：时间戳不准确
  原因：未使用 -v threadtime 格式
  解决：始终使用 -v threadtime 获取毫秒级时间戳