cube sdio fatfs 初始化sd卡_乾坤合一~Linux SD/MMC/SDIO驱动分析(下)

实例

一、概述

最近在研究WIFI驱动，驱动模块为broamd4330，基于SDIO接口，所以趁机研究了一下内核中对于SDIO设备的注册。

（我使用的linux内核版本为3.2.0 硬件为samsung 4412）

在介绍内核之前，有必要先了解一下MMC SD SDIO三种卡，从发展历程来看，是先有MMC卡，后来有SD卡，这两种都是纯粹的存储卡，而SDIO是什么呢，从字面意思理解，应该是SD+IO，也就是既有存储功能，又有IO控制功能，不过也有纯IO功能的SDIO设备（本人用到的WIFI模块就是这种）。并且，这三种卡可以使用同一个插槽，系统还能正确的识别！！，可能是由于历史原因，在开始有Linux的时候，还只存在mmc卡（不存在SD和SDIO卡），所以在linux系统里面关于这三种卡的名称统统用“mmc“来命名。

下面来看一下CPU与WIFI模块的物理连接图

从图上可以看出，我们的WIFI模块接的是CPU上的mmc3，数据线，时钟线以及命令线都一一对应。

当然在CPU一端，对于mmc3模块，还有一个很重要的引脚--“xmmc3CDn”脚，CPU就是根据该引脚的电平高低来判断mmc3模块上是否有卡接入，如果电平为低，表示有卡，如果为高，表示无卡，笔者这里将该引脚固定拉低。

同时在WIFI模块一端，也有一个很重要的引脚--“WL_SDIO_SPI_HSCI_SEL”引脚 ，它是用来选择模块是工作在SD模式（低电平），还是SPI模式（高电平），笔者这里也将该引脚固定拉低。

好了，简单的介绍了一些概念以及硬件后，还是要回归到程序上，从大的方面来讲，MMC/SD/SDIO的驱动程序主要分为两大块，主设备驱动和从设备驱动。对于上面的例子来说，CPU上的MMC3模块就是主设备，而WIFI模块就是从设备。该系列的博文就是分析MMC主设备在内核中的注册，以及对于同一个mmc插槽，系统是如何区分出MMC SD 以及SDIO设备的。

二、host注册过程

　　上面说到了MMC/SD/SDIO（以下简称MMC）的驱动从大的方面来说分为主设备驱动和从设备驱动，那本文就来详细的讲述主设备驱动注册的过程。

　　MMC主设备（也就是host）指的是集成于CPU内部的MMC controller，笔者用的是4412芯片，从datasheet可以看出，里面集成了四个MMC controller,分别是mmc0,mmc1,mmc2,mmc3。并且从上一篇文章我们知道，WIFI模块是接在mmc3 这个host上面。

在linux系统中，将每个host设备封装成platform_device来逐一进行注册。

对于笔者所使用的内核（3.2.0版本）来说，每一个host设备所对应的platform_device文件位于目录（$KERNEL_SOURCE）/arch/arm/plat-samsung下，分别为dev-hsmmc.c，dev-hsmmc1.c，dev-hsmmc2.c，dev-hsmmc3.c，为了与实际WIFI模块对应，我们重点进入dev-hsmmc3.c文件看一看：

从上图可以看出，该文件里面定义了一个名为s3c_device_hsmmc3的platform_device，但是定义好了的platform_device还需要有一个注册的过程，该过程就发生在文件（$KERNEL_SOURCE）/arch/arm/mach-exynos/mach-$(BOARD).c中，其中有如下的一个函数调用：

它的行为就是将数组skd4x12_devices里面的每一个platform_device项一一注册进系统，并且这个数组里面就包含了上面所定义的s3c_device_hsmmc3：

　　所以总结来说，系统化在初始化的时候，就已经将s3c_device_hsmmc3（也就是那个host mmc3）注册进了platform总线（其他的mmc0,mmc1,mmc2都是一个道理）。

　　当然，对于熟悉platform机制的朋友来说，此时仅仅只是注册了platform_device ，而对应的platform_driver还没有注册。

下面就来说说这个platform_driver的注册，它是在$(KERNEL_SOURCE)/drivers/mmc/host目录下的sdhci-s3c.c文件中进行的，该文件中有如下的一个注册函数调用：

其中的参数sdhci_s3c_driver就是上面所说的platform_driver，它也是定义在sdhci-s3c.c文件中，来看一下：

在对sdhci_s3c_driver进行注册的过程中，系统会根据sdhci_s3c_driver->driver.name成员变量（此处是“s3c-sdhci”）在platform_bus 总线上寻找同名字的platform_dvice（这个过程称之为“探测”），通过上面对s3c_device_hsmmc3的注册分析，发现s3c_device_mmc3.name也刚好是“s3c-sdhci”,所以他俩刚好可以配对，探测成功，同时当大家查阅s3c_device_hsmmc,s3c_device_hsmmc1以及s3c_device_hsmmc2的时候发现他们的name成员变量都是“s3c-sdhci”,，所以会有四次成功的探测，每一次探测成功，就会调用sdhci_s3c_driver.probe函数---sdhci_s3c_probe，这个函数至关重要，在整个驱动注册过程中起着核心作用。

上面文章说到了探测函数sdhci_s3c_probe，现在就来仔细分析这个函数的作用：

在分析代码之前，先简要的概括一下这个函数的功能：

1、既然是讲host的注册，那么首先必须构造出一个host，这个host就是通过sdhci_alloc_host函数来构造出来的，它是一个struct sdhci_host类型的结构体。同时，也通过mmc_alloc_host函数构造了一个struct mmc_host的结构体变量mmc。

2、初始化host的时钟，设置host的gpio等等其他一些“乱七八糟”的参数初始化（需要的时候再详细分析）。

3、通过sdhci_add_host函数来注册host。

下面重点来看sdhci_add_host函数

该函数主要是对mmc的注册，同样mmc也有很多的参数，先来看看他的操作函数集mmc->ops = &sdhci_ops

其中，request函数指针指向的函数用来处理host向从设备发送命令的请求，

set_ios用来设置电源、时钟等等之类（需要重点关注），

get_ro用来判断是否写保护

再来看该函数里面的中断注册部分

我们先看一下mmc_add_host这个函数，它的功能就是通过device_add函数将设备注册进linux设备模型，最终的结果就是在sys/bus/platform/devices目录下能见到s3c-sdhci.1,s3c-sdhci.2,s3c-sdhci.3设备节点。

中断注册函_irq的第一个参数中断号就取自于s3c_device_hsmmc3.resource里面的irq参数，sdhci_irq就是中断服务程序，该中断函数一般在插卡、拔卡或者从设备反馈给host信息时会被调用数request

中断服务程序

程序首先读取寄存器NORINTSTSn的值，该寄存器中有两个bit分别来表示卡的插入与拔出过程（注意，必须是动态变化过程，才会让相应的两个bit置1）,那么接下来的if语句就是从该寄存器的那两个bit来判断是否有卡的插入或拔出，并同时清除这两个bit，准备下一次的检测，紧接着就调用中断的下半部分函数 sdhci_tasklet_card，其实这个函数也没做什么事情，就是判读如果此时有卡的话就通过mmc_detect_chang函数调用mmc_rescan函数。从这个函数的名字都可以猜出个八九不离十，它的功能就是扫描所插入的卡。

扫描卡的程序

这个函数我们重点关注上述两个地方，其实真正的扫描动作发生在函数mmc_rescan_try_freq函数里面，该函数的第二个参数表示以什么样的频率去进行扫描，那么可选的频率值在那个数组freqs里面，一般当用某个频率值扫描成功后，就直接退出了，否则，会以下一个更低的频率值来扫描，笔者所使用的WIFI模块就是以400KHz的频率扫描成功的。

扫描过程

该函数首先发送复位命令（不过该命令只有SDIO类型的卡才能够识别），然后发送CMD0，让设备进入IDLE模式，紧接着发送CMD8，获取该卡所支持的电压值，最后就是重点了（从1998-2003行），从所调用的各个函数名字可以看出，它是在试探该卡是否为SDIO? SD? MMC?

那么接下来的文章就是要分析上面的三个函数，看它是如何识别SDIO、SD、MMC的。

三、SDIO的识别和操作

从上面文章的最后，我们知道host在扫描卡的过程中，其识别的顺序为SDIO SD MMC，并且从它的注释可以看出，这个顺序是很重要的。那这篇文章，我们就看看SDIO的识别过程，它对应的函数就是mmc_attach_sdio(host) (函数位于文件drivers/mmc/core/sdio.c)

这个函数大概来说做了如下的工作

1、向卡发送CMD5命令，该命令有两个作用：

第一，通过判断卡是否有反馈信息来判断是否为SDIO设备（只有SDIO设备才对CMD5命令有反馈，其他卡是没有回馈的）；

第二，如果是SDIO设备，就会给host反馈电压信息，就是说告诉host，本卡所能支持的电压是多少多少。

2、host根据SDIO卡反馈回来的电压要求，给其提供合适的电压。

3、初始化该SDIO卡

4、注册SDIO的各个功能模块

5、注册SDIO卡

对于以上功能的具体解释，下面将结合程序娓娓道来

1、CMD5命令的发送

第789行的函数就是发送的CMD5命令，如果卡对该命令有回馈的话，err就是0，否则，err为非0，直接退出了；并且需要重点说明的一点就是，该函数的最后一个参数ocr,它是存储反馈命令的，SDIO设备对CMD5的反馈命令为R4，下面来仔细分析一下这个R4，因为后面要用到这个R4命令。从SDIO spec文档里面，我们能得到R4命令的格式

从上图可以看出，该命令有48位，但我们的ocr变量是32位的，那怎么存储呢？系统就去掉原命令的开头8位以及结尾的8位，只保留中间的32为，也就是截短后的命令格式是如下：

具体各位的描述如下：

C -- 我还不知道

Number 0f IO functions -- 每个SDIO设备都有功能块，这三位就记录了该设备有多少个功能块，最多7个

Memory Present – 指明该设备是纯粹只有功能块的设备，还是同时包含了存储空间，如果为0就是前者，如果是1就是后者

Stuff Bits -- 没有实际用途一般为0

I/O OCR – 该设备所能支持的电压范围（具体描述见sdio spec）

2、配置电压

ocr就是我们上面讲的反馈命令R4（截短之后的32位），那么ocr&0x7f的意义是什么呢？从R4的格式就可以看出来，其低24位就代表了所能支持的电压范围，我们再来详细的看一下这24位的OCR格式

现在应该可以知道ocr&0x7f的意义了吧，就是摈弃那些保留的电压范围。

重点关注mmc_select_voltage

第1080行的相与 过程就是判断host实际所支持的电压与card所需要的电压是否匹配，如果匹配，那么ocr的值就非0，否则就为0

简单介绍下第1082行的ffs函数，它的作用就是返回参数中第一个为1的bit的位置（ffs(0)=0,ffs(1)=1,ffs(8)=4）,那么该函数用在这里的作用就是取出card需要的实际电压是多少；

第1090行的mmc_set_ios函数里面通过调用sdhci_set_power将host->ios.vdd所代表的电压写入寄存器PWRCONn中 完成那个对电压的重新配置（想要了解更详细的过程，请跟踪源代码）

3、初始化SDIO卡

第821行就是初始化SDIO卡的函数 这个函数很长，也很重要，这里笔者就不列出其程序代码了，只是列出其中最重要的几条：

1、通过函数mmc_alloc_card分配一个mmc_card的变量card

2、通过读取R4命令中的bit27（也就是Memory Present）来判断此卡是纯IO卡 ，还是同时包含存储功能。笔者使用的WIFI模块为纯IO功能，所以card->type = MMC_TYPE_SDIO(这个很重要，以后会用到) （接下来重点分析MMC_TYPE_SDIO的情况）

3、通过发送CMD3命令获取设备的从地址（relative addr）,并且存放在变量card->rca中。笔者使用的WIFI模块的card->rca = 1

4、通过发送CMD7，选中相应从地址的卡

5、通过调用函数mmc_set_clock设置卡工作的时钟频率

6、通过发送CMD52命令，设置4位数据传输模式

4、注册SDIO功能模块

847行的变量funcs存储该SDIO卡所包含的IO功能块的个数，851行到857行就是逐一初始化各个IO功能块，下面来重点看一下该函数的内容:

第71行就是分配sdio_func结构体变量，该结构体存储了功能块的参数。

第75行就是给功能块编号，编号是从1到7（因为一个SDIO设备最多只有7个功能块），存储在变量func->num中

第78行就是读取SDIO卡中的FBR寄存器中关于该卡的功能类型的数据，存储在func->class变量中（具体关于FBR寄存器内容，可以参考SDIO spec文档）

第82行就是读取SDIO卡中的CIS寄存器的内容

上面的程序就是将功能模块逐个的注册进设备模型，这里想重点说明一下注册的名称（name），它是由三部分组成的，每部分之间用冒号隔开，（即 host的名称：rca：功能块编号)。

具体到笔者使用的WIFI模块，因为其host名称是mmc2 ,rca = 1,并且有两个功能模块(功能模块编号分别是1和2)，所以在/sys/bus/sdio/devices目录下能见到如下两个设备名

• mmc2:0001:1
• mmc2:0001:2

5、注册SDIO卡

上面的mmc_add_card函数就是注册card了（这个card是在第3部分，初始化SDIO卡 里面分配和定义的）

　第259行就是给card命名，格式为host名字：从地址,对于笔者的WIFI模块 就是mmc2:0001

第261到273行就是根据card->type来分辨出card的类型，给赋予相应的字符串，笔者的WIFI模块就是"SDIO"

第275行就是打印信息，具体不解释 笔者的打印信息为 mmc2:new high speed SDIO card at address 0001(通常可以通过查看内核启动信息中是否有该语句来判断card是否被正确识别)

第283行 就是将card注册进linux设备模型 注册结果就是可以在/sys/bus/mmc/devices目录下见到card 的名字，笔者的就是mmc2:0001