小白也能懂-SDIO总线:Linux驱动框架篇

大家好，我是快乐学习，开心分享的科技探索员 🎉

上一篇《硬件原理篇》我们搞清了 SDIO 总线的物理通信原理和信号定义。今天第②篇，我们要深入 Linux 内核驱动层，系统学习 MMC/SDIO 子系统的架构设计、关键数据结构、设备枚举流程、以及驱动开发的完整框架。

这一篇的目标很明确：让你理解驱动开发的本质——如何通过一套标准的框架代码，让你的硬件设备被内核识别和管理。理解了这个，才能真正写出生产级的驱动代码。⚠️

一、MMC子系统的分层架构设计

Linux 内核采用分层驱动框架管理所有 MMC 设备（SD卡、eMMC、SDIO等）。这个设计遵循了通用的设备驱动模型：

💡 关键设计原则：分层隔离 - 上层驱动层不需关心硬件细节，Core 层负责协议逻辑，Host 层负责操作具体的硬件控制器。

【架构示意图】

二、Host 层 - 硬件控制器驱动

Host 层是与硬件最接近的一层，负责操作 SDIO Host 控制器（SoC 上的 SDIO 模块）。

1. mmc_host 结构体

每个 SDIO Host 控制器对应一个 mmc_host 实例。它是 Core 层和 Host 驱动之间的桥梁。

关键成员：

• ops：操作函数集（request、set_ios、get_ro、get_cd 等）

• f_min / f_max：主机支持的时钟范围

• max_seg_size、max_segs：DMA 传输的分段限制

• max_blk_size、max_blk_count：单次读写的块大小限制

• caps：设备能力标志位（支持 4-bit、8-bit、高速模式等）

• pm_caps：电源管理能力（支持运行时 PM、睡眠唤醒等）

2. mmc_host_ops 回调集

Host 驱动必须实现这些关键回调函数：

⚠️ request() 回调是 Host 驱动的核心 - 这里是发送实际 SD 命令和数据的地方。

三、Core 层 - MMC/SDIO 协议处理

Core 层是 Linux 为 MMC 设备定义的标准协议栈，负责：设备发现、协议状态机、总线管理、电源管理。

1. 设备枚举与状态机

当卡插入时，Core 层执行标准的 SDIO 初始化流程：

▲ ① mmc_rescan：启动卡扫描流程（通常由工作队列定期执行或中断触发）

▲ ② CMD0 复位：发送 GO_IDLE_STATE，将卡复位到 Idle 态

▲ ③ CMD5 识别：发送 IO_SEND_OP_COND 识别 SDIO 卡（非 SDIO 卡则尝试 SD/MMC）

▲ ④ CID 读取：发送 CMD2 获取卡 ID（cid）

▲ ⑤ RCA 分配：发送 CMD3，Host 给卡分配相对地址（rca）

▲ ⑥ CSD 读取：发送 CMD9 获取卡特性（csd - card-specific data）

▲ ⑦ Function枚举：读取 SDIO 卡的 Function 信息（每个 func 对应一个逻辑设备）

💡 这个序列对应 SDIO 3.0 规范。流程中任何一步失败，都会导致设备枚举失败。

2. mmc_card 与 sdio_func 结构体

枚举成功后，内核为物理卡创建 mmc_card 结构，为每个逻辑功能创建 sdio_func 结构。

关键结构体及其含义：

• mmc_card：代表物理 SDIO 卡

成员：cid、csd、ocr、rca、state、host 指针

• sdio_func：代表卡上的一个功能

成员：num(功能号)、device、vendor、class、irq_handler

【数据结构关系图】

四、Driver 层 - SDIO功能驱动

这是你要写的代码所在的层。通过标准的 sdio_driver 框架，你的驱动可以：

• 1. 与总线进行匹配（通过 vendor/device ID）

• 2. 在设备插入时被自动调用（probe）

• 3. 独立地管理自己的功能单元（多驱动可同时运行）

1. SDIO 驱动框架的三个关键概念

(1) sdio_device_id - 设备匹配

通过 vendor ID 和 device ID 声明你的驱动支持的设备列表：

(2) sdio_driver 结构体 - 驱动定义

声明你的驱动信息和回调函数：

(3) 总线匹配流程

当新的 sdio_func 出现时，SDIO 总线驱动会遍历所有注册的驱动，逐个尝试匹配，匹配成功则调用 probe()。

2. probe 与 remove 回调

驱动的核心入口

probe()函数：

✓ 验证 func 是否有效且支持所需的 I/O 能力

✓ 申请驱动私有数据结构（通常用 sdio_set_drvdata() 关联）

✓ 初始化硬件（使能 func、配置参数、注册中断等）

✓ 注册为内核驱动（如网络设备 register_netdev()、字符设备 cdev_add() 等）

✓ 返回 0 表示成功，非零表示失败（此时 remove() 不会被调用）

remove() 函数：

✓ 注销内核驱动注册（unregister_netdev()、cdev_del() 等）

✓ 禁用 SDIO 功能（sdio_disable_func()）

✓ 释放硬件资源

✓ 释放驱动分配的内存

五、完整驱动代码 - 包含错误处理和最佳实践

一个生产级的 SDIO 驱动应该包含的完整代码框架：

💡 关键细节：

• sdio_claim_host() / sdio_release_host()：必须在操作 SDIO 设备前后调用，确保独占访问（防止竞争）

• devm_kzalloc()：内核自动管理内存释放，简化错误处理

• sdio_set_drvdata() / sdio_get_drvdata()：关联驱动数据和 func，方便在回调函数中访问

• 错误处理：probe 失败时必须完全清理资源，避免内存泄漏

六、SDIO 驱动常用 API 快速参考

七、驱动开发中的常见陷阱与调试技巧

1. 常见问题与解决方案

❌ probe 没有被调用

→ 检查 ID 表是否正确、设备 vendor/device ID 是否匹配、驱动是否真的注册了

❌ 读写设备时崩溃

→ 99% 是因为没有 claim_host，导致并发访问；或内存指针无效

❌ 中断处理函数未被触发

→ 确认硬件支持 SDIO IRQ、确认 enable_func 后设备是否真的能产生中断

❌ DMA 传输出错

→ 缓冲区必须对齐、必须是 DMA 可达的内存（不能是栈变量）；使用 sdio_align_size()

❌ 设备枚举超时

→ 可能 Host 时钟配置错误、电压不对、或硬件本身有问题

2. 调试工具与命令

查看系统识别的 SDIO 设备：

查看驱动加载和 probe 过程（实时日志）：

启用 SDIO 驱动调试（内核编译选项）：

使用 trace 工具跟踪命令执行：

八、小结与下一步

✅ MMC 子系统的分层架构（Host / Core / Driver）

✅ Host 层如何操作硬件控制器

✅ Core 层的设备枚举状态机和关键数据结构

✅ Driver 层的框架设计和完整代码实现

✅ 生产级驱动应该具备的错误处理和最佳实践

✅ 常见陷阱和调试工具

现在你对 SDIO 驱动开发已经有了深入的理解。下一篇《应用层接口与实战篇》，我们将从用户态角度学习如何通过 ioctl/read/write 与驱动通信，并通过真实的 WiFi 驱动案例串联起整个知识体系。

喜欢这篇文章？点个「在看」，让更多工程师看到它 👇

关注「科技探索员」，每期深入一个技术点，不讲玄学，只讲干货。