linux SD卡初始化---mmc_sd_init_card函数
为了学习SD/SDIO协议,看了一下linux中初始化SD卡的流程,结合代码更容易SD初始化是怎么做的。
下面图截自:"SD Specifications Part 1 Physical Layer Simplified Specification Version 4.10"
SD卡在sd模式下的初始化流程图,sd协议还有spi模式暂不研究。
这个流程图对应于linux 代码就在
/driver/mmc/core/sd.c
static int mmc_sd_init_card(struct mmc_host *host, u32 ocr, struct mmc_card *oldcard)
传入参数
truct mmc_host *host mmc/sd/sdio主机控器的结构,成员用到再说明
u32 ocr 这个比较重要,与ACMD41和sd卡中ocr寄存器相关。调用mmc_sd_init_card之前
linux已经做过一些工作,就是发送ACMD41获取SD卡工作电压,与Host支持电压匹配并设置host的电压,然后调用mmc_sd_init_card,并把电压信息通过ocr传递下来。流程图开始时这些工作已经做好。
struct mmc_card *oldcard 新插入的卡初始化时该值为NULL。
linux版本3.7 mmc_sd_init_card函数:
1 /* 2 * Handle the detection and initialisation of a card. 3 * 4 * In the case of a resume, "oldcard" will contain the card 5 * we're trying to reinitialise. 6 */ 7 static int mmc_sd_init_card(struct mmc_host *host, u32 ocr, 8 struct mmc_card *oldcard) 9 { 10 struct mmc_card *card; 11 int err; 12 u32 cid[4]; 13 u32 rocr = 0; 14 15 BUG_ON(!host); 16 WARN_ON(!host->claimed); 17 18 err = mmc_sd_get_cid(host, ocr, cid, &rocr); 19 if (err) 20 return err; 21 22 if (oldcard) { 23 if (memcmp(cid, oldcard->raw_cid, sizeof(cid)) != 0) 24 return -ENOENT; 25 26 card = oldcard; 27 } else { 28 /* 29 * Allocate card structure. 30 */ 31 card = mmc_alloc_card(host, &sd_type); 32 if (IS_ERR(card)) 33 return PTR_ERR(card); 34 35 card->type = MMC_TYPE_SD; 36 memcpy(card->raw_cid, cid, sizeof(card->raw_cid)); 37 } 38 39 /* 40 * For native busses: get card RCA and quit open drain mode. 41 */ 42 if (!mmc_host_is_spi(host)) { 43 err = mmc_send_relative_addr(host, &card->rca); 44 if (err) 45 return err; 46 } 47 48 if (!oldcard) { 49 err = mmc_sd_get_csd(host, card); 50 if (err) 51 return err; 52 53 mmc_decode_cid(card); 54 } 55 56 /* 57 * Select card, as all following commands rely on that. 58 */ 59 if (!mmc_host_is_spi(host)) { 60 err = mmc_select_card(card); 61 if (err) 62 return err; 63 } 64 65 err = mmc_sd_setup_card(host, card, oldcard != NULL); 66 if (err) 67 goto free_card; 68 69 /* Initialization sequence for UHS-I cards */ 70 if (rocr & SD_ROCR_S18A) { 71 err = mmc_sd_init_uhs_card(card); 72 if (err) 73 goto free_card; 74 75 /* Card is an ultra-high-speed card */ 76 mmc_card_set_uhs(card); 77 78 /* 79 * Since initialization is now complete, enable preset 80 * value registers for UHS-I cards. 81 */ 82 if (host->ops->enable_preset_value) { 83 mmc_host_clk_hold(card->host); 84 host->ops->enable_preset_value(host, true); 85 mmc_host_clk_release(card->host); 86 } 87 } else { 88 /* 89 * Attempt to change to high-speed (if supported) 90 */ 91 err = mmc_sd_switch_hs(card); 92 if (err > 0) 93 mmc_sd_go_highspeed(card); 94 else if (err) 95 goto free_card; 96 97 /* 98 * Set bus speed. 99 */ 100 mmc_set_clock(host, mmc_sd_get_max_clock(card)); 101 102 /* 103 * Switch to wider bus (if supported). 104 */ 105 if ((host->caps & MMC_CAP_4_BIT_DATA) && 106 (card->scr.bus_widths & SD_SCR_BUS_WIDTH_4)) { 107 err = mmc_app_set_bus_width(card, MMC_BUS_WIDTH_4); 108 if (err) 109 goto free_card; 110 111 mmc_set_bus_width(host, MMC_BUS_WIDTH_4); 112 } 113 } 114 115 host->card = card; 116 return 0; 117 118 free_card: 119 if (!oldcard) 120 mmc_remove_card(card); 121 122 return err; 123 }
18行,err = mmc_sd_get_cid(host, ocr, cid, &rocr);字面意思就是获取CID,对照着流程图给该函数注释:
1 /* 2 * Fetch CID from card. 3 */ 4 int mmc_sd_get_cid(struct mmc_host *host, u32 ocr, u32 *cid, u32 *rocr) 5 { 6 int err; 7 u32 max_current; 8 9 /* 10 * Since we're changing the OCR value, we seem to 11 * need to tell some cards to go back to the idle 12 * state. We wait 1ms to give cards time to 13 * respond. 14 */ 15 mmc_go_idle(host);//发送CMD0 16 17 /* 18 * If SD_SEND_IF_COND indicates an SD 2.0 19 * compliant card and we should set bit 30 20 * of the ocr to indicate that we can handle 21 * block-addressed SDHC cards. 22 */ 23 err = mmc_send_if_cond(host, ocr);//发送CMD8,
24 if (!err) 25 ocr |= SD_OCR_CCS;//如果返回失败,说明卡不是SD2.0或之后的版本,如果是2.0的SD卡,把ocr的30位置1,即协议里ACMD41命令中的HCS.
26 表示支持SDHC或SDXC,ACMD41命令见下面图示
27 /* 28 * If the host supports one of UHS-I modes, request the card 29 * to switch to 1.8V signaling level. 30 */ 31 if (host->caps & (MMC_CAP_UHS_SDR12 | MMC_CAP_UHS_SDR25 | 32 MMC_CAP_UHS_SDR50 | MMC_CAP_UHS_SDR104 | MMC_CAP_UHS_DDR50)) 33 ocr |= SD_OCR_S18R; //判断主机控制器是否支持UHS-I host->caps通常在主机控制器驱动的probe函数里面初始化,值和具体主机控制器
有关.如果支持那么就把ocr的24位置1,即ACMD41命令的S18R.表示要求SD卡准备切换到1.8V电压模式
34 35 /* 36 * If the host can supply more than 150mA at current voltage, 37 * XPC should be set to 1. 38 */ 39 max_current = sd_get_host_max_current(host);
40 if (max_current > 150) 41 ocr |= SD_OCR_XPC;//SDXC中Power Control相关的项,ocr第28位,ACMD41中的XPC
42 43 try_again: 44 err = mmc_send_app_op_cond(host, ocr, rocr);//发送ACMD41,这个函数你可以进去看一下,会发现循环检验ACMD41的,应答值的31位,与
协议流程图中符合.rocr就是卡对ACMD41的应答值.另外ACMD41属于app cmd需要先发送CMD55,这个linux都封装在了函数里,并且流程图上也简化掉了.
45 if (err) 46 return err; 47 48 /* 49 * In case CCS and S18A in the response is set, start Signal Voltage 50 * Switch procedure. SPI mode doesn't support CMD11. 51 */ 52 if (!mmc_host_is_spi(host) && rocr && 53 ((*rocr & 0x41000000) == 0x41000000)) {//这个if语句,先判断是不是spi模式,是spi模式就不继续,我只分析SD模式所以继续
判断rocr即ACMD41的应答值的CSS(30位)和S18A(24位)这两位具体意义见代码下面的图表.只有当sd卡是SDHC或SDXC,并且SD卡准备好切换电压模式,才切换
SDSC不进行切换.
54 err = mmc_set_signal_voltage(host, MMC_SIGNAL_VOLTAGE_180, true);//发送CMD11切换,主机端也做相应的处理.
55 if (err) { 56 ocr &= ~SD_OCR_S18R; 57 goto try_again; 58 } 59 } 60 61 if (mmc_host_is_spi(host)) 62 err = mmc_send_cid(host, cid); 63 else 64 err = mmc_all_send_cid(host, cid);//发送CMD2.获取cid,即Card IDentification register,存放了一些卡的信息,
到这里发现已经到了流程图的底部,只剩CMD3了
65 66 return err; 67 }
ACMD41命令:
图中红线标出的就是代码中rocr的值.关于该命令更多的内容见SD的spec.
回到mmc_sd_init_card函数,
22~37行与协议无关,主要是初始化一个struct mmc_card *card结构体.这个结构体就相当于这张卡的身份证,从卡的CID,CSD..寄存器拿到的值都要填到该结构中备用.
43行 err = mmc_send_relative_addr(host, &card->rca),发送CMD3获取RCA,得到卡的地址.流程图到这里就结束了. mmc_sd_init_card却没有结束.
接下来还要获取SD卡的CSD寄存器的值,来填充struct mmc_card *card结构体.
49行 err = mmc_sd_get_csd(host, card);发送CMD9获取CSD并解析,填充到card.CSD寄存器保存了大量卡的信息.
53行 mmc_decode_cid(card); 解析前面获得的CID并填充到card,这一步为什么不在前面获得cid的时候做? 是因为sd卡协议有不同版本而版本信息放在CSD中,所以需要先得到CSD,获得版本号,在根据版本号解析CID中的数据. 详细内容见spec中寄存器部分.
60行 err = mmc_select_card(card);发送CMD7使用上面得到的地址选择卡
65行 err = mmc_sd_setup_card(host, card, oldcard != NULL);发送ACMD51获取SCR寄存器值,发送ACMD13获取SD卡状态信息,解析并填充card结构,SCR寄存器是对CSD的补充.
最后69~113行 if else语句,判断是否是UHS-I,分别进行处理.先看一下esle中的代码
先调用 err = mmc_sd_switch_hs(card);,支持高速就发命令把卡设置到高速
1 int mmc_sd_switch_hs(struct mmc_card *card) 2 { 3 int err; 4 u8 *status; 5 6 if (card->scr.sda_vsn < SCR_SPEC_VER_1)//判断卡的版本,SD1.1和之后的版本支持高速 7 return 0; 8 9 if (!(card->csd.cmdclass & CCC_SWITCH))//判断是否支持class10命令 10 return 0; 11 12 if (!(card->host->caps & MMC_CAP_SD_HIGHSPEED))//判断主机控制器是否支持高速卡 13 return 0; 14 15 if (card->sw_caps.hs_max_dtr == 0)/*这个值什么情况下会为0? 该值赋值是在mmc_read_switch函数中,发送CMD6命令时赋值的,如果不支持HIGHSPEED就没有赋值. 16 通常sd卡驱动中使用CMD6命令,都会发送两次,第一次查询卡是否支持接下来要做的切换(在mmc_read_switch中). 17 第二次执行切换操作.CMD6命令详细内容见spec*/ 18 return 0; 19 20 err = -EIO; 21 22 status = kmalloc(64, GFP_KERNEL);//分配64bytes的空间.用于接收CMD6的应答数据. 23 if (!status) { 24 pr_err("%s: could not allocate a buffer for " 25 "switch capabilities.\n", mmc_hostname(card->host)); 26 return -ENOMEM; 27 } 28 29 err = mmc_sd_switch(card, 1, 0, 1, status);//发送CMD6切换卡到高速 30 if (err) 31 goto out; 32 33 if ((status[16] & 0xF) != 1) {//切换结果在第17字节,也是spec中规定的 34 pr_warning("%s: Problem switching card " 35 "into high-speed mode!\n", 36 mmc_hostname(card->host)); 37 err = 0; 38 } else { 39 err = 1; 40 } 41 42 out: 43 kfree(status); 44 45 return err; 46 }
93行,设置主机这边,最终会调用host驱动,与你host硬件有关.
100行,mmc_set_clock(host, mmc_sd_get_max_clock(card));//设置时钟频率,mmc_sd_get_max_clock(card)是用的card->sw_caps.hs_max_dtr或card->csd.max_dtr.如果支持高速linux会设置为card->sw_caps.hs_max_dtr,这个值在之前被赋为
50000000.
105~111 同样需要host和card同时支持4bit宽度,才能设置,并且要同时设置host和card
err = mmc_app_set_bus_width(card, MMC_BUS_WIDTH_4);设置卡的总线宽度,使用的命令是ACMD6
至此,mmc_sd_init_card函数就结束了. linux中的初始化处理过程基本上与spec中的流程图相符. 之后还有设置时钟,设置数据线宽度等操作.
还有一个关于UHS-I的分支没有分析,这个放到下篇分析.并且其中又涉及到CMD6,顺便简单分析学习一下CMD6的使用.