3. GPU驱动基础
在SA8155平台中，GPU驱动并不是一个孤立的字符设备，而是由硬件架构、内核驱动框架、设备树描述、电源时钟资源以及中断机制共同构成的一条完整通路。理解这条通路，是后续调试MDP合成、渲染卡顿、GPU频率异常和功耗问题的前提。本节围绕Adreno GPU的硬件结构、KGSL驱动框架、设备树节点、电源与时钟管理以及中断处理机制展开，帮助建立从硬件到内核的完整认知。
一、Adreno GPU架构：从硬件模块到驱动视角
SA8155搭载的Adreno GPU属于统一着色器架构，其核心模块包括命令处理器（CP）、着色器核心、纹理单元、渲染后端、L2缓存以及GPU管理控制器（GMU）。从驱动视角看，CPU并不直接操作每一个着色器核心，而是通过命令流将渲染任务提交给GPU。命令处理器负责解析命令流，调度着色器执行，并在任务完成后产生中断。
Adreno GPU的地址空间分为GPU虚拟地址和物理地址，KGSL负责维护GPU页表，将GPU虚拟地址映射到系统物理内存。GPU内部还有独立的微码（microcode）运行在GMU上，用于频率调节、电源状态切换和硬件队列管理。因此，驱动调试时不能只看CPU侧寄存器，还要关注GMU状态和GPU页表映射。
二、KGSL驱动框架：用户态与内核态的桥梁
KGSL（Kernel Graphics Support Layer）是高通Adreno GPU在Linux内核中的驱动框架。它向上提供字符设备接口/dev/kgsl-3d0，向下管理GPU硬件、内存、电源和中断。用户态图形库（如OpenGL ES、Vulkan驱动）通过ioctl向KGSL提交命令，KGSL负责将命令放入环形缓冲区（ringbuffer），并触发GPU执行。
KGSL的主要职责包括：命令提交与调度、GPU内存管理、电源与时钟控制、中断处理、GPU故障恢复。在SA8155平台上，KGSL还与MDP、显示子系统存在资源竞争关系，因此调试GPU问题时需要同时关注MDP通路是否占用了过多带宽或电源资源。
# 查看KGSL设备节点
ls -l /dev/kgsl-3d0
# 查看GPU频率与负载
cat /sys/class/kgsl/kgsl-3d0/gpuclk
cat /sys/class/kgsl/kgsl-3d0/gpu_busy_percentage
# 查看GPU电源状态
cat /sys/class/kgsl/kgsl-3d0/pwrscale/trustzone/governor三、设备树节点：硬件资源的描述入口
在SA8155平台中，GPU硬件资源通过设备树节点描述。设备树节点告诉内核：GPU寄存器基地址在哪里、使用哪个中断、需要哪些时钟和电源域、IOMMU如何配置、支持哪些频率档位。没有正确的设备树节点，KGSL驱动无法完成探测（probe），GPU也就无法正常工作。
典型的GPU设备树节点包含以下关键属性：compatible用于匹配驱动；reg描述寄存器地址范围；interrupts描述中断号；clocks和clock-names描述时钟源；power-domains描述电源域；iommus描述IOMMU映射；qcom,gpu-pwrlevels描述频率电压档位。调试时如果GPU probe失败，应优先检查设备树节点是否完整、时钟和电源域是否被其他节点占用。
dtc -I fs /proc/device-tree 反编译当前设备树，确认GPU节点下的 clocks、power-domains、interrupts 属性与实际硬件一致。若属性缺失，KGSL probe 会返回 -EPROBE_DEFER 或 -ENODEV。四、电源与时钟管理：GPU功耗与性能的平衡
Adreno GPU的电源管理分为多个层次：GPU电源域（GX、CX、MX）、时钟源（GFX3D、RBBM、GMU）、频率电压档位以及GMU微码控制的动态调频。KGSL通过pwrscale框架与GMU协作，根据GPU负载动态调整频率和电压。在SA8155平台上，GPU频率档位通常由qcom,gpu-pwrlevels节点定义，每个档位包含频率、电压和总线带宽要求。
调试GPU功耗问题时，需要关注以下几点：GPU是否频繁进出低功耗状态；频率是否被限制在较低档位；电源域是否被其他子系统（如MDP、摄像头）占用；GMU微码是否正常加载。如果GPU频率始终无法提升，可能是电源域冲突或热限制触发。
| 资源类型 | 设备树属性 | 调试节点 | 常见问题 |
|---|---|---|---|
| 寄存器 | reg | /proc/iomem | 地址冲突导致probe失败 |
| 中断 | interrupts | /proc/interrupts | 中断号错误导致无响应 |
| 时钟 | clocks / clock-names | /sys/kernel/debug/clk | 时钟未使能导致GPU挂死 |
| 电源域 | power-domains | /sys/kernel/debug/pm_genpd | 电源域被占用无法上电 |
| IOMMU | iommus | /sys/kernel/debug/iommu | 页表映射失败导致GPU异常 |
| 频率档位 | qcom,gpu-pwrlevels | /sys/class/kgsl/kgsl-3d0/devfreq | 档位缺失导致频率受限 |
五、中断处理机制：GPU任务完成的信号链
GPU中断是KGSL驱动与硬件交互的关键机制。当GPU完成一个命令队列或发生异常时，会向CPU发送中断。KGSL的中断处理分为上半部（top half）和下半部（bottom half）：上半部快速读取中断状态寄存器，确认中断源并清除中断；下半部处理具体的任务完成、错误恢复和队列调度。
Adreno GPU的中断源主要包括：RBBM中断（渲染后端）、CP中断（命令处理器）、GMU中断（电源管理）以及GPU异常中断。调试GPU挂死问题时，可以通过/proc/interrupts查看GPU中断计数是否增长，通过KGSL的debugfs节点查看命令队列状态和GPU故障信息。
# 查看GPU中断计数
cat /proc/interrupts | grep -i kgsl
# 查看KGSL调试信息
cat /sys/kernel/debug/kgsl/kgsl-3d0/gpu_state
cat /sys/kernel/debug/kgsl/kgsl-3d0/active_contexts
# 查看GPU故障记录
dmesg | grep -i "kgsl\|adreno\|gpu fault"六、案例与复盘：GPU probe失败排查
在某SA8155项目中，GPU驱动加载后/dev/kgsl-3d0未生成，dmesg显示kgsl-3d0: probe failed with error -517。错误码-517表示-EPROBE_DEFER，说明驱动依赖的资源尚未就绪。排查步骤如下：首先检查设备树中GPU节点的power-domains属性，发现其引用的电源域节点尚未被其他驱动注册；其次检查时钟节点，发现GPU时钟父节点未使能；最后确认IOMMU节点是否已就绪。修复电源域和时钟依赖后，GPU probe成功，设备节点正常生成。
这个案例说明，GPU驱动调试不能只盯着KGSL本身，还要关注设备树依赖、电源域、时钟和IOMMU等系统级资源。只有把GPU驱动放在整个SA8155平台的资源拓扑中理解，才能快速定位问题。