[mmc subsystem] host（第三章）——sdhci-pltfm说明

mmc subsystem系列（持续更新中）：
[mmc subsystem] 概念与框架

[mmc subsystem] mmc core（第一章）——概述
[mmc subsystem] mmc core（第二章）——数据结构和宏定义说明
[mmc subsystem] mmc core（第三章）——bus模块说明
[mmc subsystem] mmc core（第四章）——host模块说明
[mmc subsystem] mmc core（第五章）——card相关模块（mmc type card）
[mmc subsystem] mmc core（第六章）——mmc core主模块

[mmc subsystem] host（第一章）——概述
[mmc subsystem] host（第二章）——sdhci
[mmc subsystem] host（第三章）——sdhci-pltfm说明
[mmc subsystem] host（第四章）——host实例（sdhci-msm说明）

建议先参考《[mmc subsystem] 概念与框架》对整体有一个了解。

==========================================================================================================

一、sdhci-pltfm说明

sdhci-pltfm并不是实际某个host的driver。
sdhci-pltfm是指在sdhci core的基础上，提供了统一对sdhci_host的必要属性进行解析和设置的方法。
但是，对于sdhci类的host driver来说，使用sdhci-pltfm并不是必须的，host driver也可以自己来实现对应的操作。
通过《host（第二章）——sdhci》，我们知道了host driver调用sdhci_add_host注册sdhci_host的之前需要设置的信息如下：

• sdhci的寄存器的映射过后的基地址（sdhci_host->ioaddr）
• sdhci的癖好quirks、quirks2（sdhci_host->quirks，sdhci_host->quirks2）
• sdhci的中断号（sdhci_host->irq）
• host提供给sdhci core用来操作硬件的操作集（sdhci_host->ops）

因此，sdhci-pltfm实现了两个方法来统一设置这些信息，方便host driver对于sdhci driver的使用。
后续继续说明。

二、数据结构说明

1、sdhci_pltfm_data

首先看一下sdhci-pltfm要设置的sdhci_host的成员的来源信息：

• sdhci的寄存器的映射过后的基地址（sdhci_host->ioaddr）
  由DTS节点中的地址属性解析出来寄存器的物理地址之后，进行映射得到
• sdhci的癖好quirks、quirks2（sdhci_host->quirks，sdhci_host->quirks2）
  由平台host驱动（host driver）提供最基本的值，后续会进行调整
• sdhci的中断号（sdhci_host->irq）
  由DTS节点中的中断属性解析出来
• host提供给sdhci core用来操作硬件的操作集（sdhci_host->ops）
  由平台host驱动（host driver）提供

综上，ops、quirks和quirks2这几个的值是必须由平台host驱动（host driver）提供，而ioaddr和irq可以通过解析属性得到。
因此，sdhci-pltfm把ops、quirks和quirks2的值封装到sdhci_pltfm_data中，由底层host驱动提供。

其内容如下：

struct sdhci_pltfm_data {    const struct sdhci_ops *ops;   // host提供给sdhci core用来操作硬件的操作集    unsigned int quirks;   // sdhci的癖好quirks    unsigned int quirks2;  // sdhci的癖好quirks2};

2、sdhci_pltfm_host

sdhci_pltfm也为host抽象出一个host结构体sdhci_pltfm_host来作为sdhci_host和平台定制的host的中间层。

struct sdhci_pltfm_host {    struct clk *clk;    /* migrate from sdhci_of_host */    unsigned int clock;    u16 xfer_mode_shadow;    unsigned long private[0] ____cacheline_aligned;};

以高通定制的host结构体sdhci_msm_host为例，三者之间的关系如下：

sdhci_host->private = sdhci_pltfm_hostsdhci_pltfm_host->priv = sdhci_msm_hostplatform_get_drvdata(sdhci_msm_host->struct platform_device) = sdhci_hostsdhci_pltfm_host = sdhci_priv(sdhci_host);sdhci_msm_host= sdhci_pltfm_priv(sdhci_pltfm_host);

三、API总览

1、sdhci_pltfm分配和释放相关

• sdhci_pltfm_init & sdhci_pltfm_free
  由底层host driver调用。
  sdhci_pltfm_init 用于分配sdhci_pltfm_host和sdhci_host的部分成员进行设置。
  sdhci_pltfm_free用于释放sdhci_pltfm_host和sdhci_host。

    原型：struct sdhci_host *sdhci_pltfm_init(struct platform_device *pdev, const struct sdhci_pltfm_data *pdata)    参数说明：struct platform_device *pdev——》host对应的平台设备的device                    struct sdhci_pltfm_data *pdata——》需要host driver提供给sdhci_host的一些信息，前面说过了    使用案例：sdhci_pltfm_init(pdev, &msm_host->sdhci_msm_pdata);    原型：void sdhci_pltfm_free(struct platform_device *pdev)

2、属性解析相关

• sdhci_get_of_property
  由底层host driver调用。
  用来解析host的dtsi节点的部分属性，前提是要求这部分属性必须按照一定的规范来。

    原型：void sdhci_get_of_property(struct platform_device *pdev)

3、sdhci_host注册相关

• sdhci_pltfm_register & sdhci_pltfm_unregister
  由底层host driver调用。
  sdhci_pltfm_register 直接根据sdhci_pltfm_data来注册一个sdhci_host，会调用上述的sdhci_pltfm_init 和sdhci_get_of_property操作。
  注意，但是一般用得比较少，因为host driver得到sdhci_host可能需要根据自己的需求来设置sdhci_host，而不是马上注册sdhci_host。

    原型：int sdhci_pltfm_register(struct platform_device *pdev, const struct sdhci_pltfm_data *pdata)    参数说明：struct platform_device *pdev——》host对应的平台设备的device                    struct sdhci_pltfm_data *pdata——》需要host driver提供给sdhci_host的一些信息，前面说过了

四、接口代码说明

1、sdhci_pltfm_init

• 主要工作

  • 调用sdhci_alloc_host分配一个sdhci_host
  • 根据sdhci_pltfm_data设置sdhci_host->ops
  • 根据sdhci_pltfm_data设置sdhci_host->quirks
  • 根据sdhci_pltfm_data设置sdhci_host->quirks2
  • 获取dtsi节点中的第一个中断属性并申请，设置sdhci_host->irq
  • 获取dtsi节点中的第一个寄存器属性并映射，设置sdhci_host->ioaddr
  • 调用平台的初始化操作

• 具体代码如下

struct sdhci_host *sdhci_pltfm_init(struct platform_device *pdev,                    const struct sdhci_pltfm_data *pdata){// struct platform_device：sdhci host的平台设备// const struct sdhci_pltfm_data：sdhci host的平台数据结构体，包含了对应host的sdhci_ops操作集    struct sdhci_host *host;    struct sdhci_pltfm_host *pltfm_host;    struct device_node *np = pdev->dev.of_node;    struct resource *iomem;    int ret;/* 获取sdhci内存资源区域 */    iomem = platform_get_resource(pdev, IORESOURCE_MEM, 0); // 所以在dtsi节点中，sdhci的内存资源必须作为内存列表的第一个属性！！！！/* 调用sdhci_alloc_host获取一个标准的struct sdhci_host结构体 */        host = sdhci_alloc_host(&pdev->dev, sizeof(*pltfm_host));/* 将struct sdhci_host的私有数据和struct sdhci_pltfm_host关联 */    pltfm_host = sdhci_priv(host);/* 根据传进来的sdhci host的平台数据来初始化sdhci_host的ops、quirks */    host->hw_name = dev_name(&pdev->dev);    host->ops = pdata->ops;    host->quirks = pdata->quirks;/* 获取中断 */    host->irq = platform_get_irq(pdev, 0);  // 所以在dtsi节点中，sdhci的中断属性必须作为中断列表的第一个属性！！！！！/* 申请sdhci的内存资源并且进行映射 */    if (!request_mem_region(iomem->start, resource_size(iomem),        mmc_hostname(host->mmc))) {        dev_err(&pdev->dev, "cannot request region\n");        ret = -EBUSY;        goto err_request;    }    host->ioaddr = ioremap(iomem->start, resource_size(iomem));    if (!host->ioaddr) {        dev_err(&pdev->dev, "failed to remap registers\n");        ret = -ENOMEM;        goto err_remap;    }/* 调用host->ops->platform_init进行初始化 */    if (host->ops && host->ops->platform_init)        host->ops->platform_init(host);/* 将struct sdhci_host作为对应host的私有数据 */    platform_set_drvdata(pdev, host);    return host;}

注意，通过上述代码，sdhci-pltfm要求必须把sdhci的寄存器属性放在host的dtsi的寄存器属性的第一个，同时，也要把sdhci的中断属性放在host的dtsi的中断属性的第一个。简单dtsi的例子如下图所示：

        sdhc_1: sdhci@07824000 {        reg = <0x07824900 0x11c>, <0x07824000 0x800>;        reg-names = "hc_mem", "core_mem";   // 其中，hc_mem表示sdhci的寄存器属性，放在了第一个        interrupts = <0 123 0>, <0 138 0>;        interrupt-names = "hc_irq", "pwr_irq";   // 其中，hc_irq表示sdhci的中断，放在了第一个

2、sdhci_get_of_property

代码如下：

void sdhci_get_of_property(struct platform_device *pdev){    struct device_node *np = pdev->dev.of_node;    struct sdhci_host *host = platform_get_drvdata(pdev);    // 从平台设备结构体中获取私有数据，对应就是sdhci_host    struct sdhci_pltfm_host *pltfm_host = sdhci_priv(host);    // sdhci_host的私有护具就是struct sdhci_pltfm_host    const __be32 *clk;    u32 bus_width;    int size;    if (of_device_is_available(np)) {        if (of_get_property(np, "sdhci,auto-cmd12", NULL))            host->quirks |= SDHCI_QUIRK_MULTIBLOCK_READ_ACMD12;                // 解析"sdhci,auto-cmd12"属性，设置quirks的SDHCI_QUIRK_MULTIBLOCK_READ_ACMD12标识                // sdhci,auto-cmd12————》SDHCI_QUIRK_MULTIBLOCK_READ_ACMD12                //  Controller uses Auto CMD12 command to stop the transfer，控制器使用CMD12自动结束传输        if (of_get_property(np, "sdhci,1-bit-only", NULL) ||            (of_property_read_u32(np, "bus-width", &bus_width) == 0 &&            bus_width == 1))            host->quirks |= SDHCI_QUIRK_FORCE_1_BIT_DATA;                // 解析"sdhci,1-bit-only"属性，设置quirks的SDHCI_QUIRK_FORCE_1_BIT_DATA标识                // sdhci,1-bit-only————》SDHCI_QUIRK_FORCE_1_BIT_DATA                // Controller can only handle 1-bit data transfers，该sdhci controller只支持1bit位宽传输        if (sdhci_of_wp_inverted(np))            host->quirks |= SDHCI_QUIRK_INVERTED_WRITE_PROTECT;                // sdhci,wp-inverted | wp-inverted————》SDHCI_QUIRK_INVERTED_WRITE_PROTECT        if (of_get_property(np, "broken-cd", NULL))            host->quirks |= SDHCI_QUIRK_BROKEN_CARD_DETECTION;                // broken-cd————》SDHCI_QUIRK_BROKEN_CARD_DETECTION                // Controller has unreliable card detection，sdhci controller没有实现card检测        if (of_get_property(np, "no-1-8-v", NULL))            host->quirks2 |= SDHCI_QUIRK2_NO_1_8_V;                // no-1-8-v————》SDHCI_QUIRK2_NO_1_8_V                //  The system physically doesn't support 1.8v, even if the host does，不支持1.8V        clk = of_get_property(np, "clock-frequency", &size);        if (clk && size == sizeof(*clk) && *clk)            pltfm_host->clock = be32_to_cpup(clk);                // clock-frequency————》pltfm_host->clock                // 获取时钟频率        if (of_find_property(np, "keep-power-in-suspend", NULL))            host->mmc->pm_caps |= MMC_PM_KEEP_POWER;        if (of_find_property(np, "enable-sdio-wakeup", NULL))            host->mmc->pm_caps |= MMC_PM_WAKE_SDIO_IRQ;    }}

3、sdhci_pltfm_register

使用得比较少，简单了解下即可。

int sdhci_pltfm_register(struct platform_device *pdev,             const struct sdhci_pltfm_data *pdata){    struct sdhci_host *host;    int ret = 0;/* 调用sdhci_pltfm_init分配并初始化一个sdhci_host */    host = sdhci_pltfm_init(pdev, pdata);            if (IS_ERR(host))        return PTR_ERR(host);/* 调用sdhci_get_of_property解析dtsi属性并设置sdhci_host的部分成员 */    sdhci_get_of_property(pdev);/* 调用sdhci_add_host将该sdhci_host注册到sdhci core中 */    ret = sdhci_add_host(host);    if (ret)        sdhci_pltfm_free(pdev);    return ret;}