1. SA8155 平台概述

1.1 SA8155 芯片架构总览

SA8155 是 Qualcomm 面向第三代智能座舱域控制器推出的旗舰级 SoC，采用 7nm FinFET 工艺。其核心计算单元包括 Kryo 485 CPU（1+3+4 三丛集）、Adreno 640 GPU、Hexagon 690 DSP、Spectra 380 ISP 以及专用的 NPU（HVX 向量扩展）。芯片通过统一内存架构（UMA）与 LPDDR5 控制器连接，所有主控单元共享系统内存。

1.2 GPU 子系统：Adreno 640

Adreno 640 是 Qualcomm 第 6 代移动 GPU 架构，在 SA8155 中运行频率最高可达 675MHz。其内部包含 2 个着色器处理器（SP）核心，每个 SP 包含 384 个 ALU（算术逻辑单元），总计 768 个 ALU。GPU 通过 AXI 总线与系统内存控制器直连，支持 64 位虚拟地址空间。

1.3 GPU 驱动栈整体框架

SA8155 平台的 Adreno GPU 驱动栈采用经典的三层架构：用户空间 API 层、内核空间 DRM/KMS 层、以及固件层。驱动栈的核心组件包括 KGSL（Kernel Graphics Support Layer）驱动、MSM DRM 驱动以及 Adreno 固件。

1.4 各层职责与关键接口

1.5 驱动栈数据流路径

一个典型的渲染帧从用户空间到 GPU 硬件的完整路径如下：

1. API 调用： 应用程序调用 vkQueueSubmit() 或 glDrawElements()。
2. UMD 构建命令： 用户模式驱动将 API 调用翻译为 Adreno 微码命令，写入到 KGSL 分配的内存缓冲区中。
3. ioctl 提交： UMD 通过 ioctl(KGSL_IOCTL_SUBMIT_COMMANDS) 将命令缓冲区句柄传递给 KGSL 内核驱动。
4. KGSL 调度： KGSL 将命令放入硬件队列，并通过写寄存器 0x3C00 通知 GPU 命令处理器（CP）。
5. CP 解析： GPU 内部的命令处理器从系统内存中读取命令缓冲区，解析并分发给 SP0/SP1。
6. SP 执行： 着色器处理器执行顶点/片元着色器，纹理单元采样，ROP 写入帧缓冲。
7. 完成通知： GPU 写回 fence 值，KGSL 通过中断或轮询检测完成，唤醒等待的应用程序。

1.6 调试入口与工具链

在 SA8155 平台上，Adreno 驱动调试主要依赖以下内核接口和用户空间工具：

• KGSL debugfs： /sys/kernel/debug/kgsl/kgsl-3d0/ 目录下包含 busy、mem、clk、registers 等节点，可直接读取 GPU 状态。
• MSM DRM debugfs： /sys/kernel/debug/dri/0/ 提供显示控制器状态、帧缓冲信息。
• Qualcomm 官方工具： snapdragon-profiler 支持 GPU 计数器捕获、着色器性能分析。
• 内核日志： dmesg 中 KGSL 和 MSM DRM 的 dev_err / dev_warn 输出是定位驱动崩溃的第一手信息。
• 性能计数器： 通过 KGSL_IOCTL_GPU_COUNTER_READ 读取 ALU 利用率、纹理单元负载、L2 命中率等硬件计数器。

# 快速检查 GPU 是否挂起
cat /sys/kernel/debug/kgsl/kgsl-3d0/busy
# 输出示例：1287 (ms) 表示 GPU 在最近采样周期内忙碌了 1287ms

# 查看当前 GPU 频率
cat /sys/kernel/debug/kgsl/kgsl-3d0/clk
# 输出示例：675000000

# 查看 GPU 内存使用情况
cat /sys/kernel/debug/kgsl/kgsl-3d0/mem
# 输出示例：imported: 128 MB, mapped: 96 MB