一个面向自学者和工程师的 GPU 驱动课程型仓库，采用“roadmap + sessions + labs”的组织方式，帮助你系统学习 Linux GPU 驱动栈，并逐步过渡到真实驱动源码阅读、运行时观察和实验复盘。

这个仓库不是单纯的一篇学习笔记，而是一套以 session 为核心的学习工作区。它把 24 周路线拆成可执行的学习单元，每个单元都有对应 lab，用来把概念、源码路径和实验记录连起来。

• docs/ 保存序言、路线图、源码阅读清单和每周复盘模板。
• sessions/ 把 roadmap 里的每个学习主题映射成一个课程单元。
• labs/ 提供同号实验任务，帮助把“看懂”变成“能验证、能复盘”。

• 有 C 语言和基础操作系统知识，想进入 GPU 驱动方向的人。
• 想系统学习 Linux DRM/KMS、显存管理、命令提交和同步机制的人。
• 做图形、编译器、系统软件或内核开发，想补 GPU 驱动知识的人。

• 说清 Linux 图形栈的主要分层和职责。
• 看懂 DRM/KMS 的常见对象和关键数据流。
• 读懂简单 GPU 驱动的初始化、buffer 管理和命令提交流程。
• 对 i915/xe、amdgpu、msm、panfrost 这类真实驱动有明确切入点。
• 熟练使用 IGT (igt-gpu-tools) 进行内核驱动测试，并能分析常见 GPU Hang 和 Reset 的错误日志。

.
├─ .gitignore
├─ LICENSE
├─ CONTRIBUTING.md
├─ README.md
├─ docs/
│  ├─ preface.md
│  ├─ roadmap.md
│  ├─ reading_checklist.md
│  └─ weekly-template.md
├─ sessions/
│  ├─ README.md
│  ├─ session-01-environment-and-stack/
│  │  └─ README.md
│  ├─ session-02-c-and-kernel-structures/
│  │  └─ README.md
│  ├─ ...
│  └─ session-24-retrospective-and-next-plan/
│     └─ README.md
├─ labs/
│  ├─ README.md
│  ├─ lab-01-environment-and-stack/
│  │  └─ README.md
│  ├─ lab-02-c-and-kernel-structures/
│  │  └─ README.md
│  ├─ ...
│  └─ lab-24-retrospective-and-next-plan/
│     └─ README.md

建议按下面顺序使用这个仓库：

1. 先读 序言，了解学习目标和方法。
2. 再读 长期路线图，建立 24 周整体地图。
3. 初始化源码 submodule，把 Linux、Mesa、libdrm 和 IGT 准备到本地。
4. 从 Session 导航 开始，按顺序推进。
5. 在对应时间窗口完成配套 lab。
6. 用 每周复盘模板 记录自己的输出。

上游源码不直接提交到本仓库，而是通过 Git submodule 固定在 sources/ 目录中。主仓库只记录外部仓库的 URL 和 commit，源码内容仍然来自各自上游仓库。

首次 clone 时可以直接带上 submodule：

git clone --recurse-submodules --shallow-submodules <this-repo-url>

如果已经 clone 了本仓库，再初始化源码：

git submodule update --init --depth 1 --filter=blob:none

这会准备下面几个源码目录：

• sources/linux：Linux kernel，建议配合 GPU 学习相关的 sparse checkout。
• sources/mesa：Mesa 用户态图形驱动。
• sources/libdrm：DRM 用户态 ioctl 封装库。
• sources/igt-gpu-tools：DRM/KMS 测试工具。

如果暂时不想下载 Linux kernel，可以先只初始化较小的用户态仓库：

git submodule update --init --depth 1 --filter=blob:none sources/mesa sources/libdrm sources/igt-gpu-tools

需要更新到上游新版本时：

git submodule update --remote --depth 1 --filter=blob:none
git add .gitmodules sources/linux sources/mesa sources/libdrm sources/igt-gpu-tools
git commit -m "Update source submodules"

Windows 原生文件系统对大小写不敏感，完整 checkout Linux kernel 时可能遇到少量非 GPU 目录的大小写冲突警告。建议优先在 WSL/Linux 文件系统中初始化 sources/linux。如果已经在 Windows 原生目录中初始化，可以把 Linux submodule 调成 GPU 学习用 sparse checkout：

git -C sources/linux sparse-checkout init --cone
git -C sources/linux sparse-checkout set Documentation/gpu drivers/base drivers/dma-buf drivers/gpu drivers/iommu drivers/pci include/drm include/linux include/uapi/drm kernel/dma kernel/irq mm

• Session 导航
• Session 01：环境准备与图形栈总览
• Session 10：Atomic modeset 与 IGT 基础
• Session 13：阅读 vkms
• Session 19：Page fault、Hang 与 Reset

lab 现在按 session 一一对应组织，建议直接从总索引进入：

• Lab 导航
• Session 01 对应 Lab 01
• Session 02 对应 Lab 02
• ...
• Session 24 对应 Lab 24

Lab 不等于“每周都必须写内核模块”。在这套课程里，只要能留下可复查的证据，下面几类都算有效 lab：

1. 代码实验：编写最小用户态程序、调用 ioctl、修改或加载 vkms。
2. 路径追踪：用源码、ftrace、bpftrace 或日志追一次真实调用链。
3. 对象解剖：阅读关键结构体，画出对象关系、生命周期或状态流转。
4. 调试记录：运行 IGT、观察 debugfs、分析 dmesg 或 perf/trace 输出。

建议每周按同一个节奏推进：先读 session，明确问题；再做同号 lab，留下证据；最后用复盘模板记录“我现在能解释什么、还卡在哪里”。

当前仓库已经切换到 session 主导的结构，后续执行时可以使用以下辅助文档来驱动学习并检验产出进度：

• 源码阅读 Checklist：进入陌生驱动目录时，用它快速找到入口、对象、提交、同步和调试线索。
• 每周复盘模板：每周把实验、路径追踪、问题清单和下一步计划写下来。

• docs/preface.md
• docs/roadmap.md
• docs/reading_checklist.md
• docs/weekly-template.md
• sessions/README.md
• labs/README.md