1. 课程导论：SD卡控制器模拟在QEMU中的定位、与文件系统启动验证的关系、课程目标与前置知识
1.1 SD卡控制器模拟在QEMU中的定位
QEMU作为全系统模拟器，其外设模拟层是连接虚拟CPU与真实世界I/O操作的关键桥梁。SD卡控制器（如SDHCI、SPI模式）在QEMU中属于存储类外设，位于“板级初始化 → 总线枚举 → 设备实例化 → 寄存器访问回调”这一完整模拟链路的中间层。
从QEMU源码架构来看，SD卡控制器模拟涉及以下核心模块：
| 模块路径 | 功能定位 | 关键文件 |
|---|---|---|
hw/sd/ |
SD协议层与控制器模型 | sdhci.c, sd.c, ssi-sd.c |
hw/block/ |
块设备后端抽象 | block.c, virtio-blk.c |
include/hw/sd/ |
SD设备接口定义 | sd.h, sdhci.h |
hw/arm/ / hw/riscv/ |
板级集成与设备树生成 | virt.c, sifive_u.c |
关键认知： SD卡控制器在QEMU中并非独立存在，它必须通过SysBus/PCI总线挂载到板级模型上，并通过BlockBackend与宿主机上的镜像文件交互。理解这一“控制器 ↔ 总线 ↔ 块后端”的三层关系，是后续进行文件系统启动验证的基础。
1.2 与文件系统启动验证的关系
文件系统启动验证是嵌入式开发中从“硬件模拟”到“软件运行”的关键闭环。SD卡控制器模拟的质量直接决定了以下验证链路的成败：
- BootROM加载阶段： 模拟的SD卡控制器必须正确响应CMD0、CMD8、ACMD41等初始化命令，返回正确的OCR/CID/CSD寄存器值。
- 引导程序加载： U-Boot SPL或ROM代码通过SD卡读取MBR/GPT分区表，定位FAT32/EXT4分区中的bootloader镜像。
- 内核挂载根文件系统： Linux内核通过MMC子系统驱动SDHCI控制器，读取分区中的内核镜像和设备树，最终挂载根文件系统。
- 用户空间启动： init进程从SD卡上的根文件系统执行初始化脚本，完成系统启动。
| 验证阶段 | SD卡控制器关键行为 | 常见失败原因 |
|---|---|---|
| BootROM初始化 | CMD0进入Idle状态 → CMD8检测电压 → ACMD41初始化 | OCR响应错误、超时未就绪 |
| 分区表读取 | 单块读取 (CMD17) 扇区0 (LBA0) | 块大小配置错误、DMA地址对齐问题 |
| FAT32文件读取 | 多块读取 (CMD18) 簇链遍历 | CRC校验未实现、数据缓冲区溢出 |
| 内核解压与执行 | 大块连续读取 (CMD18 + 自动CMD12停止) | 传输速率过低、中断丢失 |
| 根文件系统挂载 | EXT4/F2FS元数据与数据块随机读取 | 写回缓存不一致、电源管理状态错误 |
常见陷阱： 许多QEMU SD卡模拟实现只实现了“能读”的基本功能，但在多块传输的自动CMD12停止、DMA描述符链表的正确解析、SDHC大容量卡（>=2GB）的LBA寻址等细节上存在缺陷。这些缺陷在简单读写测试中不易暴露，但在完整的文件系统启动验证中会直接导致内核崩溃或挂载失败。
1.3 课程目标
本课程旨在帮助学员从源码级理解QEMU SD卡控制器的模拟实现，并掌握完整的文件系统启动验证方法。具体目标如下：
- 目标一： 深入理解QEMU中SDHCI控制器的寄存器模型、命令/响应状态机、DMA传输机制。
- 目标二： 掌握SD卡协议（SPI模式与SD模式）在QEMU中的实现差异与调试方法。
- 目标三： 学会使用QEMU的
-drive if=sd、-device sdhci-pci等命令行参数构建SD卡启动环境。 - 目标四： 能够独立分析并修复SD卡模拟中导致文件系统启动失败的常见Bug。
- 目标五： 掌握使用GDB调试QEMU SD卡模拟代码、使用
-d mmc跟踪SD命令交互的实战技能。
学习建议： 本课程要求学员具备一定的QEMU使用经验和C语言阅读能力。建议在学习过程中同步搭建QEMU源码编译环境，并准备一块真实的SD卡镜像（使用
qemu-img创建）用于实验验证。
1.4 前置知识要求
为确保学习效果，学员应具备以下前置知识：
| 知识领域 | 具体要求 | 推荐参考资料 |
|---|---|---|
| QEMU基础 | 能使用qemu-system-arm启动Linux内核，理解-machine、-kernel、-drive等基本参数 |
QEMU官方文档 · 《QEMU入门指南》 |
| 嵌入式系统 | 了解ARM/RISC-V启动流程、BootROM、U-Boot的基本概念 | 《嵌入式Linux基础》 · U-Boot文档 |
| 文件系统 | 熟悉FAT32/EXT4分区结构、MBR/GPT分区表、文件系统挂载过程 | 《Linux文件系统详解》 |
| C语言 | 能阅读中等复杂度的C代码，理解结构体、函数指针、链表等数据结构 | 《C程序设计语言》 |
| SD协议基础 | 了解SD卡命令/响应格式、SPI模式与SD模式的区别（非必须，课程会讲解） | SD卡物理层规范 v6.0 |
1.5 课程内容概览
本课程共分为30章，涵盖从SD卡协议基础到高级调试技巧的完整知识体系。以下是核心章节的路线图：
- 第1-5章： 基础篇 — SD卡协议回顾、QEMU SDHCI源码结构、寄存器模型详解。
- 第6-12章： 核心篇 — 命令/响应状态机实现、DMA传输、中断机制、时钟与电源管理。
- 第13-18章： 文件系统篇 — FAT32/EXT4在QEMU SD卡上的启动验证、常见失败模式分析。
- 第19-24章： 进阶篇 — 多块传输优化、SDXC支持、eMMC模拟、UHS-I模式。
- 第25-30章： 实战篇 — GDB调试SD卡模拟、性能分析、自定义SD卡控制器、贡献QEMU上游。
课程特色： 每章均配有可运行的QEMU命令行示例、源码分析片段和调试技巧。学员将亲手从零构建一个能够启动Linux的SD卡镜像，并深入理解QEMU模拟器内部的工作机制。