1. 总论
2. 主控制器
3. 协议层
4. 块设备
1. 总论
- MMC - MultiMedia Card
- SD
- Secure Digital Card
1.2 分类
- 按存储大小,普通SD卡(<=2GB,支持FAT12/FAT16),HCSD卡(>2GB,<=32GB,支持FAT32)
- 按体积大小,普通SD卡,mini-SD卡,micro-SD卡(TF卡)
1.3 速度
- 默认模式: 12.5MB/s
- 高速模式: 25MB/s
1.4 子系统代码结构
2. 主控制器
2.1 数据结构
struct pxamci_host {
};
2.1.1 struct mmc_host
struct mmc_host
};
struct mmc_host_ops {
};
struct mmc_bus_ops {
};
struct mmc_card {
};
mmc_card结构体内的数据结构主要存放SD卡的信息,其中RCA, CID, CSD, SCR为SD卡内部的32位寄存器。
struct mmc_request {
};
struct mmc_command {
};
struct mmc_data {
#define MMC_DATA_WRITE
#define MMC_DATA_READ
#define MMC_DATA_STREAM
};
2.2 驱动程序
{
}
static struct platform_driver pxamci_driver = {
};
其中,remove为probe的反操作,suspend和resume涉及电源管理的内容,本文重点讨论probe。
SD主控制器驱动程序的初始化函数probe(struct platform_device *pdev),概括地讲,主要完成五大任务,
- 初始化设备的数据结构,并将数据挂载到pdev->dev.driver_data下
-
实现设备驱动的功能函数,如mmc->ops = &pxamci_ops;
- 申请中断函数request_irq()
- 注册设备,即注册kobject,建立sys文件,发送uevent等
- 其他需求,如在/proc/driver下建立用户交互文件等
2.2.1
static int pxamci_probe(struct platform_device *pdev)
{
}
这两个函数都由/drivers/mmc/core核心层下的host.c负责具体实现,
1) mmc_alloc_host
为主设备控制器建立数据结构,建立kobject,并初始化等待队列,工作队列,以及一些控制器的配置。其中,INIT_DELAYED_WORK(&host->detect, mmc_rescan);将探测SD卡的函数mmc_rescan与工作队列host->detect关联,mmc_rescan是整个SD子系统的核心函数,本文第三部分协议层将对它作重点讨论。
struct mmc_host *mmc_alloc_host(int extra, struct device *dev)
{
}
2) mmc_add_host
完成kobject的注册,并调用mmc_rescan,目的在于在系统初始化的时候就扫描SD总线查看是否存在SD卡。注意到这里的工作队列的延时时间delay为0,因为系统启动的时候不考虑插拔SD卡,关于这个delay将在下文讨论。
int mmc_add_host(struct mmc_host *host)
{
}
void mmc_start_host(struct mmc_host *host)
{
}
{
}
{
}
{
};
};
};
{
得到SD主控制器特有数据后,将其挂载到dev.platform_data下,并最终完成对platform_device *dev的注册。
{
}
{
2.2.3 设备驱动的功能函数
};
{
};
{
}
至此,我们必须去接触SD主控制器的芯片手册了。
首先,SD主控制器由一系列32位寄存器组成。通过软件的方式,即对寄存器赋值,来控制SD主控制器,进而扮演SD主控制器的角色与SD卡取得通信。
{
}
{
}
{
}
{
}
1) 由主控芯片内部电路引起的中断
{
当调用(*request),即host->ops->request(host, mrq),即上文中的pxamci_request()后,控制器与SD卡之间开始进行一次指令或数据传输,通信完毕后,主控芯片将产生一个内部中断,以告知此次指令或数据传输完毕。这个中断的具体值将保存在一个名为MMC_I_REG的中断寄存器中以供读取,中断寄存器MMC_I_REG中相关描述如下,
->
这里需要注意,寄存器MMC_RES里已经存放了来自SD卡发送过来的response,以供读取。
{
}
{
static void
{
}
void
{
}
{
}
{
}
{
static irqreturn_t
{
}
可见,core文件夹下有针对总线的服务bus.c,针对主控制器的服务host.c,针对SD卡的服务sd.c, sd_ops.c等等。
其中,最为核心的一个函数便是之前提到的位于core.c的mmc_rescan,概括来讲,主要完成两项任务,即
- 扫描SD总线,插入SD卡
- 扫描SD总线,拔出SD卡
3.1 插入SD卡
插入SD卡,主控制器产生中断,进入中断处理函数,处理工作队列,执行mmc_rescan。
void
{
}
插入SD卡,mmc_rescan扫描SD总线上是否存在SD卡,具体的实现方法就是通过向SD卡上电,看是否能成功,以普通SD卡为例,为普通SD卡上电的函数mmc_send_app_op_cond(host, 0, &ocr);如果上电成功,则返回0,即执行if()里的mmc_attach_sd()进行总线与SD卡的绑定。如果上电失败,则返回非0值,跳过if(),尝试其他上电的方法。那么,上电方法究竟有何不同呢?具体看看mmc_send_app_op_cond()的实现过程,
int mmc_send_app_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr)
{
}
int mmc_wait_for_app_cmd(struct mmc_host *host, struct mmc_card *card, struct mmc_command *cmd, int retries)
{
}
这里的指令SD_APP_OP_COND只有SD2.0的协议支持,也就是说,只有普通SD卡支持,所以也只有普通SD卡能够成功上电。
如果上电成功,就开始进行总线与SD卡的绑定,通过mmc_attach_sd(),绑定过程可分为四步,
- 注册SD总线上的操作函数 - struct mmc_bus_ops mmc_sd_ops
- 设置主控制器的时钟和总线方式 - 通过回调函数host->ops->set_ios();
- 启动SD卡 - 根据协议,完成SD卡启动的各个步骤
- 注册SD卡设备驱动
3.1.1 注册总线上的操作函数
{
}
static void mmc_sd_attach_bus_ops(struct mmc_host *host)
{
}
void
{
}
static const struct mmc_bus_ops
};
这里的mmc_sd_detect和mmc_sd_remove就是拔出SD卡所需要用到的函数,下文将详细讨论。这里需要注意的是,插入SD卡的时候,并不执行mmc_sd_detect和mmc_sd_remove这两个函数,但是会注册它们,也就是说,这两个函数的功能已经实现,将来可以使用。
3.1.2 设置时钟和总线
{
}
u32 mmc_select_voltage(struct mmc_host *host, u32 ocr)
{
}
static inline void mmc_set_ios(struct mmc_host *host)
{
}
从这里可以体会到回调函数的精髓:协议层里利用回调函数为所有满足该协议的设备提供统一的接口,而具体实现由底层不同的设备驱动各自完成。注意到,之所以要定义一些放之四海而皆准的公用的类,比如struct mmc_host,就是需要通过struct mmc_host *host指针作为形参传到协议层所提供的接口函数中,从而得以调用。
3.1.3 启动SD卡
{
}
- SD卡的启动过程
- 得到寄存器CID, CSD, SCR, RCA的数据
- 其他操作比如切换到高速模式,初始化card
static int mmc_sd_init_card(struct mmc_host *host, u32 ocr, struct mmc_card *oldcard)
{
}
1) SD卡的启动过程
结合代码,
2) 寄存器CID, CSD, SCR, RCA
-> 发送指令并得到寄存器的值
mmc_send_cid(card,
int mmc_send_cid(struct mmc_card *card, u32 *cid)
{
}
static int mmc_send_cxd_native(struct mmc_host *host, u32 arg, u32 *cxd, intopcode)
{
}
-> 解析寄存器的值
为什么要解析?先来看看寄存器CID在SD卡协议里的定义,它是一个128位的寄存器,存放了关于这块SD卡的基本信息,就像自己的身份证。通过mmc_send_cid()将这个寄存器的数值赋给了card->raw_cid
static int mmc_decode_cid(struct mmc_card *card)
{
}
3.1.4 注册SD卡设备驱动
{
}
上文已经提到,设备驱动程序都会通过alloc_xxx()和add_xxx()两步来注册驱动,其实质是调用/drivers/base/core.c里的device_initialize()和device_add(),device_add()完成建立kobject,sys文件,发送uevent,等工作。
3.2 拔出SD卡
{
}
这里的mmc_bus_get/put(),为SD总线加上一个自旋锁,规定同时只能有一个线程在SD总线上操作。
3.2.1 bus_ops->detect()
mmc_rescan()扫描SD总线,如果发现host->ops上赋了值,即之前已有SD卡注册过,就执行bus_ops->detect()操作去探测SD总线上是否还存在SD卡,如果不存在了,就执行bus_ops->remove()拔出SD卡。之前已经提到,这个bus_ops->detect()已在mmc_attach_sd()注册完成了。
{
}
这里的mmc_claim_host(host)通过set_current_state(TASK_RUNNING);将当前进程设置为正在运行进程。
mmc_send_status()发送得到SD卡状态的请求,如果未能得到状态数据,则执行mmc_sd_remove(host)拔出SD卡。
int mmc_send_status(struct mmc_card *card, u32 *status)
{
}
主控制器发送命令CMD13,要求得到SD卡的状态寄存器CSR和SSR。
SD协议规定,状态寄存器CSR是必须的,这个32位寄存器作为R1的一个域返回给主控制器,
状态寄存器SSR作为扩充功能,具体参考SD2.0协议。
3.2.2 bus_ops->remove()
拔出SD卡,其实就是注册SD卡驱动的反操作,实质就是执行device_del()和device_put()。
static void mmc_sd_remove(struct mmc_host *host)
{
}
void mmc_remove_card(struct mmc_card *card)
{
}
4. 块设备
首先,必须知道为什么要用到块设备。在linux下,SD卡通过block块的方式(以512字节为最小单位)进行数据传输,它必须遵从块设备架构。在linux块设备层,I/O调度者通过请求队列机制负责对块数据的处理。
SD卡子系统分为三层,主设备层,协议层和块设备层。块设备驱动位于/drivers/mmc/card/block.c,主要完成两个任务,
- 建立设备节点
- 通过请求队列机制进行数据传输
插入SD卡,注册驱动成功,那么在开发板的目录/dev/block下会出现SD卡的设备节点。
179为主设备号,定义于include/linux/major.h
179:0代表这块SD卡的设备节点mmcblk0,179:1代表这块SD卡的第一个分区mmcblk0p1,即主分区,如果有第二个分区,那就是179:2,最多可以有7个分区,即179:1~179:7(定义于block.c
下面通过对块设备驱动block.c的分析,看看SD卡是如何在块设备层建立节点和传输数据的。
4.1 数据结构
每个驱动都会有一个数据结构。幸运的是,我们SD卡块设备驱动的数据结构相对简单,在mmc_blk_data里,主要有两个成员,struct gendisk *disk和struct mmc_queue queue。
1)
2)
3)
4.2 块设备驱动
首先浏览一下源码,
static int __init mmc_blk_init(void)
{
}
static struct mmc_driver mmc_driver = {
};
static int mmc_blk_probe(struct mmc_card *card)
{
}
4.2.1
- 初始化设备驱动的数据结构mmc_blk_data,并挂载到card->dev.driver_data
- 实现块备驱动的功能函数struct block_device_operations *fops
-
注册设备,即注册kobject,建立sys文件,发送uevent等
- 其他需求,如mmc_blk_set_blksize(md, card);
1) 初始化mmc_blk_data
static struct mmc_blk_data *mmc_blk_alloc(struct mmc_card *card)
{
}
完成初始化后,通过mmc_set_drvdata(card, md);将数据挂载到card->dev.driver_data下。
2) 功能函数
static const struct block_device_operations
};
static int mmc_blk_open(struct
{
}
struct
};
与字符驱动类似,通过dev_t和inode找到设备。
3) 注册驱动
void add_disk(struct gendisk *disk)
{
}
blk_register_region()在linux中实现了一种利用哈希表管理设备号的机制。
register_disk()对应alloc_disk(),完成对块设备的注册,其实质是通过register_disk()->blkdev_get()->__blkdev_get()->rescan_partitions()->add_partitions()添加分区,建立设备节点。
blk_register_queue()对应blk_init_queue()完成对请求队列的注册,其实质是通过elv_register_queue()注册请求队列的算法。
关于块设备更为具体的代码分析可参看linux那些事。
4.2.2
mmc_init_queue申请并初始化一个请求队列,开启负责处理这个请求队列的守护进程。
int
{
}
1) mmc_request
它是处理SD卡通用的申请请求的回调函数,或者说是SD卡申请请求的算法。当CPU处于not busy状态,会寻找一个请求,并试图执行它。
static void
{
}
这里我们需要关注这个处理该SD卡请求队列的算法是何时申请的,也就是何时会去申请请求,何时会去唤醒内核线程。
用到回调函数q->request_fn有三处
- 块设备驱动注册请求队列blk_register_queue()
- 驱动程序出错,清空请求队列mmc_cleanup_queue()
- 实现请求队列机制的blk_fetch_request内部本身
blk_fetch_request()->blk_peek_request()->__elv_next_request()->blk_do_ordered()->...->q->request_fn
我们不必深究所谓的电梯算法,只要知道,它是使数据得以高效通信的一种算法,算法自身决定何时去唤醒守护进程处理请求。
2) blk_init_queue()
如果一个块设备希望使用一个标准的请求处理步骤,那就必须使用blk_init_queue()。这个函数注册了q->request_fn(这里就是mmc_request),并初始化请求队列的数据结构struct request_queue。
{
}
其中的rfn就是请求队列的一个算法,即这里的mmc_request。
struct request_queue *blk_init_queue_node(request_fn_proc *rfn,
{
}
3) kthead_run()
注意到mmc_init_queue这个函数的最后,创建并运行一个名为mmcqd的线程,顾名思意,mmc queue deamon它是一个SD卡的处理请求队列的守护进程,或者说内核线程,当系统注册SD卡块设备驱动时,就通过mmc_init_queue()开启了这个内核线程。
4) mmc_queue_thread
看看这个内核线程做了些什么,
static int mmc_queue_thread(void *d)
{
}
首先,这个守护进程是一个while(1)死循环,如果没有特殊要求,即kthread_should_stop()指定要把这个内核线程终止掉,那么它将从系统启动开始一直负责处理SD卡的请求队列。
在循环内部,内核线程首先通过set_current_state(TASK_INTERRUPTIBLE);设置当前线程为可打断的等待线程,进入睡眠状态,等待其他线程唤醒它,这里唤醒它的就是处理SD卡请求的mmc_request,当mq->req为空,即当前没有请求正在处理,则通过
-> 如果没有请求,则调用schedule()交出cpu的使用权让其自由调度,等到系统空闲时,再次得到cpu控制权,并且执行continue;退出当前循环,重新开始新的循环。
-> 如果得到了一个请求,则通过set_current_state(TASK_RUNNING);将该内核线程设置为当前正在运行的进程,并调用issue_fn(),即mmc_blk_issue_rq,处理这个请求,实现主控制器与SD卡的数据传输。
5) issue_fn
驱动初始化函数probe()里的mmc_blk_alloc()里注册了这个回调函数,md->queue.issue_fn =mmc_blk_issue_rq;
这个函数将req里的成员解析成为mmc_blk_request里的指令和数据,即mmc_command和mmc_data,然后通过mmc_wait_for_req()最终实现主控制器与SD卡间的通信。
struct mmc_blk_request
};
static int
{
}