一、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_host
sdhci_pltfm_host->priv = sdhci_msm_host
platform_get_drvdata(sdhci_msm_host->struct platform_device) = sdhci_host
sdhci_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;
}