s5p4418-linux MMC驱动子系统分析

平台说明：

s5p4418

SD/MMC控制器驱动：Synopsys DesignWare Dw_mmc-pltfm.c (drivers\mmc\host) 和Dw_mmc.c (drivers\mmc\host)

linux 版本：3.4.29

驱动原理：

1.SD/MMC控制器的的接口是SDIO接口，工作方式有三种，单线，四线，SPI。

2.在MMC的设备模型中，用struct mmc_host来代表一个mmc控制器，用struct mmc_card表示一个卡，如SD卡，TF卡，emmc，wifi模块等。struct sdio_func
    表示具有SDIO功能的卡。设备struct mmc_card对应驱动struct mmc_card，总线名："mmc"；设备struct sdio_func对应驱动struct sdio_driver，总线名："sdio"；

    后者是前者的一种容器，或者是继承。

3.在drivers/mmc/*下面的三个文件夹分别是card，core，host。代表，一个块设备驱动，mmc的核心，控制器驱动。

如下图：

4.在Dw_mmc.c (drivers\mmc\host)中，控制器驱动的probe函数里，执行如下代码：

for (i = 0; i < host->num_slots; i++) {
		ret = dw_mci_init_slot(host, i);
		if (ret) {
			ret = -ENODEV;
			goto err_init_slot;
		}
	}

表示申请了三个struct mmc_host，代表三个卡槽，三个mmc控制器。在dw_mci_init_slot函数中调用了：

       struct mmc_host *mmc;
	struct dw_mci_slot *slot;

	mmc = mmc_alloc_host(sizeof(struct dw_mci_slot), &host->dev);
…………………………
if(host->pdata->mode == DMA_MODE)	
		mmc->ops = &dw_mci_ops;
	else 
		mmc->ops = &dw_mci_nodma_ops;
……………………………
mmc_add_host(mmc);
……………………………

首先是申请struct mmc_host，然后添加struct mmc_host的操作方法，最后是添加host到设备模型中，调用device_add函数。类似与申请一个IIC的adapter。

在申请struct mmc_host的阶段还调用了一个函数：INIT_DELAYED_WORK(&host->detect, mmc_rescan);当有卡插入时候调用mmc_rescan函数。这个函数的主要内容是完成对插入卡就行判断，选择不同的驱动。

/* Order's important: probe SDIO, then SD, then MMC */
	if (!mmc_attach_sdio(host))
		return 0;
	if (!mmc_attach_sd(host))
		return 0;
	if (!mmc_attach_mmc(host))
		return 0;

首先执行mmc_attach_sdio(host)

        /*
	 * Detect and init the card.
	 */
	err = mmc_sdio_init_card(host, host->ocr, NULL, 0);
……
err = sdio_init_func(host->card, i + 1);
……
err = sdio_add_func(host->card->sdio_func[i]);
……

这里重要的结构也是有三个，第一个是如果存在则申请一个struct mmc_card，调用了

/*
	 * Allocate card structure.
	 */
	card = mmc_alloc_card(host, NULL);

--------------------------------
/*
 * Allocate and initialise a new MMC card structure.
 */
struct mmc_card *mmc_alloc_card(struct mmc_host *host, struct device_type *type)
{
    struct mmc_card *card;

    card = kzalloc(sizeof(struct mmc_card), GFP_KERNEL);
    if (!card)
        return ERR_PTR(-ENOMEM);

    card->host = host;

    device_initialize(&card->dev);

    card->dev.parent = mmc_classdev(host);
    card->dev.bus = &mmc_bus_type;
    card->dev.release = mmc_release_card;
    card->dev.type = type;

    return card;
}

第二个函数是申请了struct sdio_func，调用：

	struct sdio_func *func;
	func = sdio_alloc_func(card);
----------------------------------------
/*
 * Allocate and initialise a new SDIO function structure.
 */
struct sdio_func *sdio_alloc_func(struct mmc_card *card)
{
	struct sdio_func *func;

	func = kzalloc(sizeof(struct sdio_func), GFP_KERNEL);
	if (!func)
		return ERR_PTR(-ENOMEM);

	func->card = card;

	device_initialize(&func->dev);

	func->dev.parent = &card->dev;
	func->dev.bus = &sdio_bus_type;
	func->dev.release = sdio_release_func;

	return func;
}

第三个创建设备模型，调用device_add(&func->dev);函数，创建SDIO设备。

	dev_set_name(&func->dev, "%s:%d", mmc_card_id(func->card), func->num);
ret = device_add(&func->dev);
	if (ret == 0)
		sdio_func_set_present(func);

注意：MMC设备和驱动匹配是不需要名称匹配的。只要总线名称一致就可以probe。

总的过程，就是host mmc设备的建立，等待卡的插入，自动判断卡的类型，创建不同类型的设备，驱动程序则由总线名称匹配。SDIO设备在文件Sdio_bus.c (drivers\mmc\core)   定义了其设备模型。mmc设备在Bus.c (drivers\mmc\core)  定义了设备模型。