📚 课程目录第1章课程导入

第一章课程导入：学习目标、适用人群、课程结构与开发环境搭建

SDIO（Secure Digital Input/Output）与 eMMC（Embedded Multi Media Card）是嵌入式 Linux 系统中使用频率极高的两类存储与外设接口协议。SDIO 不仅承载 WiFi、蓝牙、GPS 等无线模组，还广泛用于工业采集卡、读卡器等设备；eMMC 则是手机、平板、机顶盒、工业控制板中主流的板载存储介质。两者共享 SD 总线协议家族，但在电气特性、命令时序、控制器设计、启动流程和 Linux 驱动框架上存在显著差异。本章作为整个课程的第一讲，将明确学习目标与适用人群，梳理 30 章课程的整体结构，并带领读者从零搭建一套可运行、可调试、可验证的 Linux 内核驱动开发环境——包括内核源码获取、交叉编译工具链配置以及 QEMU 模拟平台与真实开发板的双轨验证方案。

1.1 学习目标与适用人群

本课程的核心目标是培养学员独立完成 SDIO 与 eMMC 设备驱动的设计、编码、调试与优化能力。具体而言，完成全部 30 章学习后，学员应达到以下水平：能够从零阅读 SD 总线协议规范（SD Spec Part 1 / Part 2），理解命令-响应机制、数据线状态机、CRC 校验与错误恢复流程；能够梳理 Linux 内核 MMC 子系统的分层架构（mmc_core → mmc_host → mmc_card → 具体驱动），清楚每一层的职责边界与接口函数；能够独立编写 SDIO WiFi 模组（如 RTL8822CS、AP6256）的驱动移植代码，以及 eMMC 存储设备的控制器驱动与块设备层对接；能够使用 ftrace、perf、mmc-utils 等工具定位时序问题、DMA 问题与电源管理问题。

适用人群方面，本课程主要面向三类读者。第一类是嵌入式 Linux 驱动开发工程师，他们需要为新的硬件平台适配 SDIO/eMMC 控制器驱动，或为新的 WiFi/蓝牙模组编写 SDIO 接口驱动。第二类是 BSP（Board Support Package）工程师，他们负责整板启动流程、存储子系统与无线子系统的集成，需要深入理解 eMMC 启动分区、boot 代码加载以及 SDIO 设备的枚举过程。第三类是 Linux 内核爱好者与在校学生，他们希望系统学习存储子系统与总线协议，为后续从事内核开发或存储方向研究打下基础。学员需要具备 C 语言编程能力、Linux 基本操作经验（文件系统、命令行、vim）、ARM 体系结构基础（寄存器、中断、MMU），以及至少一次嵌入式 Linux 系统移植或驱动开发的经历。

学习路径建议：如果学员是初学者，建议按章节顺序学习，每章完成至少 2 小时的动手实验；如果学员已有 SDIO 或 eMMC 开发经验，可以跳过基础章节，直接进入第 7 章（SDIO 控制器驱动框架）和第 16 章（eMMC 块设备驱动）开始学习。本课程所有实验均提供完整源码与操作手册，学员可以在 QEMU 中先行验证，再移植到真实开发板。

1.2 课程结构设计

30 章课程按照"协议基础 → SDIO 驱动 → eMMC 驱动 → 调试优化"四个阶段递进组织，每章都遵循"原理讲解 → 代码分析 → 实验验证 → 排障复盘"的教学闭环。阶段一（第 1-6 章）聚焦 SD 总线协议与 Linux MMC 子系统框架，包括 SD 命令集、寄存器定义、数据传输模式、MMC 核心层代码结构、设备枚举流程等。阶段二（第 7-15 章）深入 SDIO 驱动开发，涵盖 SDIO 控制器驱动、SDIO 卡驱动框架、WiFi 模组移植、SDIO 中断处理、异步中断（SDIO IRQ）机制、超时与错误恢复等。阶段三（第 16-24 章）转向 eMMC 驱动，包括 eMMC 5.1 协议特性、HS400 模式配置、启动分区与 RPMB、硬件复位、Cache 与 FUA 命令、块设备层对接、IO 调度器优化等。阶段四（第 25-30 章）是综合实战与调优，包括性能基准测试、功耗优化、热插拔处理、多设备并发、常见故障模式分析以及一个完整的项目实战——在 RK3568 平台上实现 SDIO WiFi + eMMC 存储的完整系统。

阶段	章节范围	核心主题	实验平台	产出物
阶段一	第 1-6 章	SD 协议、MMC 子系统、设备模型	QEMU + 虚拟 SD 控制器	内核编译环境、协议分析笔记
阶段二	第 7-15 章	SDIO 控制器驱动、WiFi 模组移植	QEMU + 开发板	SDIO WiFi 驱动源码、移植文档
阶段三	第 16-24 章	eMMC 驱动、HS400、RPMB、块设备	开发板（RK3568）	eMMC 驱动补丁、性能测试报告
阶段四	第 25-30 章	调试、优化、综合项目	开发板 + 逻辑分析仪	完整系统镜像、优化方案

课程结构设计遵循"螺旋上升"原则：每个阶段都会重新回顾前一阶段的关键概念，但视角更加深入。例如，第 3 章讲解 SD 命令集时只要求理解命令格式与基本响应；到第 12 章讲解 SDIO 中断时，会再次涉及命令超时与重试机制，但此时会结合具体硬件时序分析。这种设计确保学员在不同学习阶段对同一知识点有不同层次的理解。

1.3 开发环境搭建

开发环境是整个课程实验的基础，本节将详细说明 Linux 内核源码、交叉编译工具链、QEMU 模拟平台与真实开发板四个组成部分的搭建步骤与验证方法。所有操作均基于 Ubuntu 22.04 LTS 主机环境，内核版本锁定为 6.6 LTS，工具链使用 GCC 12.3。

1.3.1 Linux 内核源码获取与配置

推荐使用内核官方 Git 仓库获取源码，并切换到稳定的 LTS 分支。执行以下命令完成源码下载与初始配置：

# 安装必要依赖
sudo apt update
sudo apt install git make gcc flex bison libncurses-dev libssl-dev \
  libelf-dev bc python3-dev

# 克隆内核源码（使用 --depth=1 加速下载）
git clone --depth=1 --branch v6.6 https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
cd linux

# 生成默认配置（针对 ARM64 架构）
make ARCH=arm64 defconfig

# 启用 MMC/SDIO 相关选项
make ARCH=arm64 menuconfig
# 在 Device Drivers → MMC/SD/SDIO card support 中确认以下选项：
#   CONFIG_MMC=y
#   CONFIG_MMC_SDHCI=y
#   CONFIG_MMC_SDHCI_PLTFM=y
#   CONFIG_MMC_SDHCI_OF_ARASAN=y（或对应平台驱动）
#   CONFIG_MMC_SDIO=y
#   CONFIG_MMC_BLOCK=y
#   CONFIG_MMC_DEBUG=y（调试用）

内核配置完成后，需要编译内核镜像与设备树。对于 QEMU 实验，我们使用 ARM64 virt 平台，该平台在 QEMU 中提供了标准的 PCIe 与 MMIO 设备，方便模拟 SDHCI 控制器。编译命令如下：

# 编译内核与设备树
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc) Image
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc) dtbs

# 编译内核模块（如果需要）
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc) modules

版本选择说明：选择内核 6.6 LTS 的原因在于：该版本对 SDHCI 控制器驱动进行了大量重构，支持 SDIO 3.0 与 eMMC 5.1 规范，且与主流 BSP（如 Rockchip、NXP）的补丁兼容性最好。如果学员使用更新的内核（如 6.10+），部分 API 可能发生变化，需要参考内核文档自行适配。

1.3.2 交叉编译工具链安装

ARM64 交叉编译工具链可以从 Linaro 或 ARM 官方获取。推荐使用 Ubuntu 软件源中的版本，确保与内核 6.6 的兼容性：

# 安装 ARM64 交叉编译工具链
sudo apt install gcc-aarch64-linux-gnu binutils-aarch64-linux-gnu

# 验证工具链版本
aarch64-linux-gnu-gcc --version
# 输出示例：aarch64-linux-gnu-gcc (Ubuntu 12.3.0-1ubuntu1~22.04) 12.3.0

# 设置环境变量（建议写入 ~/.bashrc）
export ARCH=arm64
export CROSS_COMPILE=aarch64-linux-gnu-
export PATH=$PATH:/usr/bin

工具链安装完成后，可以通过编译一个简单的 Hello World 程序验证交叉编译环境是否正常：

# 编写测试程序
cat < hello.c
#include <stdio.h>
int main() { printf("SDIO/eMMC Course\n"); return 0; }
EOF

# 交叉编译并检查文件类型
aarch64-linux-gnu-gcc hello.c -o hello
file hello
# 输出：hello: ELF 64-bit LSB executable, ARM aarch64, version 1 (SYSV)

1.3.3 QEMU 模拟平台搭建

QEMU 是课程实验的核心验证平台。我们使用 QEMU 的 ARM64 virt 机型，该机型支持 PCIe 总线、MMIO 设备、串口与网络，可以完整模拟 SDHCI 控制器。安装与启动步骤如下：

# 安装 QEMU
sudo apt install qemu-system-arm qemu-utils

# 创建根文件系统镜像（使用 Buildroot 或 Ubuntu Base）
# 这里以 Buildroot 为例，生成 ext4 格式的根文件系统
# 假设已生成 rootfs.ext4

# 启动 QEMU 虚拟机
qemu-system-aarch64 \
  -machine virt \
  -cpu cortex-a72 \
  -smp 4 \
  -m 2G \
  -kernel linux/arch/arm64/boot/Image \
  -drive file=rootfs.ext4,format=raw,if=virtio \
  -append "root=/dev/vda rw console=ttyAMA0" \
  -device virtio-net-pci,netdev=net0 \
  -netdev user,id=net0 \
  -device sdhci-pci \
  -nographic

QEMU 启动后，系统会挂载根文件系统并进入 shell。此时可以通过 ls /sys/bus/sdio/devices/ 查看 SDIO 设备，或通过 cat /proc/partitions 查看 eMMC 块设备。QEMU 的 sdhci-pci 设备模拟了标准的 SDHCI 控制器，支持 SD 2.0/3.0 协议，可以满足课程大部分实验需求。

QEMU 局限性说明：QEMU 模拟的 SDHCI 控制器不支持 eMMC 的 HS400 模式、RPMB 分区、硬件复位等高级特性。这些功能必须在真实开发板上验证。因此，本课程采用"QEMU 验证逻辑 + 开发板验证硬件"的双轨策略。学员在 QEMU 中完成驱动代码的初步调试后，必须移植到开发板进行时序与性能验证。

1.3.4 真实开发板准备

课程推荐使用 Rockchip RK3568 或 NXP i.MX8M Plus 开发板，这两款芯片都内置了高性能 SDHCI 控制器，支持 SDIO 3.0 与 eMMC 5.1。以 RK3568 为例，开发板准备步骤如下：

# 1. 获取 Rockchip BSP 内核（基于 6.6 内核）
git clone https://github.com/rockchip-linux/kernel.git -b linux-6.6-rkr1
cd kernel

# 2. 配置 RK3568 默认配置
make ARCH=arm64 rockchip_linux_defconfig

# 3. 编译内核与设备树
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc) Image
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc) dtbs

# 4. 编译 U-Boot（用于启动）
git clone https://github.com/rockchip-linux/u-boot.git
cd u-boot
make ARCH=arm64 rk3568_defconfig
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc)

# 5. 烧录到开发板（使用 RKDevTool 或 dd 命令写入 SD 卡）

开发板连接方面，需要准备 USB 转串口模块（用于串口调试）、逻辑分析仪（用于 SD 总线时序分析）、以及稳定的 5V/3A 电源。SDIO WiFi 模组通过开发板上的 M.2 或 SDIO 接口连接，eMMC 芯片则直接焊接在板载存储位置。

1.4 环境验证与常见问题

环境搭建完成后，必须进行完整的验证流程，确保后续实验可以顺利进行。验证步骤包括：内核编译验证、QEMU 启动验证、开发板启动验证、SDIO 设备枚举验证、eMMC 块设备读写验证。以下是一个典型的验证流程：

内核编译验证：确认 Image 文件生成，大小在 30-50MB 之间，且无编译错误。
QEMU 启动验证：启动后进入 shell，执行 dmesg | grep mmc 查看 MMC 子系统初始化日志。
SDIO 设备枚举：在 QEMU 中执行 ls /sys/bus/sdio/devices/，应能看到模拟的 SDIO 设备。
eMMC 块设备验证：执行 cat /proc/partitions，确认 mmcblk0 设备存在。
开发板启动验证：通过串口观察 U-Boot 与内核启动日志，确认 eMMC 控制器初始化成功。

验证项	预期结果	常见问题	排查方法
内核编译	Image 文件生成	缺少头文件或库	安装 libssl-dev、libelf-dev
QEMU 启动	进入 shell	内核 panic	检查设备树与根文件系统
SDIO 枚举	设备出现在 sysfs	控制器驱动未加载	检查 CONFIG_MMC_SDHCI_PCI
eMMC 读写	dd 命令读写成功	块设备未注册	检查 CONFIG_MMC_BLOCK
开发板启动	U-Boot 加载内核	DDR 初始化失败	检查电源与时钟配置

常见误区提醒：很多初学者在搭建环境时，容易忽略内核配置中的 CONFIG_MMC_DEBUG 选项。该选项会输出详细的 MMC 子系统调试信息，包括命令发送、响应接收、状态转换等，是排查协议问题的重要工具。建议在开发阶段始终开启该选项，但在产品发布时关闭以减少日志开销。

另一个常见问题是 QEMU 中 SDHCI 设备的中断路由。如果 QEMU 启动后 SDIO 设备无法枚举，可以尝试在 QEMU 命令行中添加 -device sdhci-pci,id=sdhci0 并检查 dmesg 中的中断注册信息。对于开发板，如果 eMMC 无法识别，首先检查硬件连接（特别是 CMD 线的上拉电阻），然后确认设备树中 mmc 节点的 bus-width 属性是否设置为 8（eMMC）或 4（SDIO）。

最后，建议学员在开始正式课程前，完成一次完整的"环境自检"：在 QEMU 中编写一个简单的字符设备驱动，通过 insmod 加载并验证 printk 输出。这可以确认交叉编译工具链、内核模块编译环境、QEMU 文件系统挂载等环节是否全部正常。只有环境完全就绪，后续的 SDIO/eMMC 驱动开发才能高效进行。

📚 课程目录

第一章 课程导入：学习目标、适用人群、课程结构与开发环境搭建

1.1 学习目标与适用人群

1.2 课程结构设计

1.3 开发环境搭建

1.3.1 Linux 内核源码获取与配置

1.3.2 交叉编译工具链安装

1.3.3 QEMU 模拟平台搭建

1.3.4 真实开发板准备

1.4 环境验证与常见问题

第一章课程导入：学习目标、适用人群、课程结构与开发环境搭建