在start_armboot()函数中调用mmc_initialize(0)初始化mmc;最终调用到int hi_mci_initialize(unsigned int dev_num)函数;内容如下:
static int hi_mci_initialize(unsigned int dev_num)
{struct mmc *mmc = NULL;static struct himci_host *host;unsigned int regval;unsigned long base_addr = 0;HIMCI_DEBUG_FUN("Function Call");/* enable SDIO clock and clock 50MHz 使能时钟且设置时钟为50M*/hi_mci_sys_init(dev_num);base_addr = SDIO0_BASE_REG; //SDIO基地址/* check controller version. 检查控制器协议*/regval = himci_readl(base_addr + MCI_VERID);if ((regval != MCI_VERID_VALUE) && (regval != MCI_VERID_VALUE2)) {printf("MMC/SD/EMMC controller version incorrect.\n");return -ENODEV;}host = malloc(sizeof(struct himci_host)); //申请内存if (!host)return -ENOMEM;memset(host, 0, sizeof(struct himci_host));mmc = &host->mmc; //获得host中的mmc变量,下面准备填充mmc;mmc->priv = host;//私有指针放上级(父)对象;host->base = base_addr;//赋值基地址host->dma_des = hi_dma_des;host->dev_id = dev_num;//设备编号host->card_status = hi_mci_sys_card_detect(host);//探测卡状态host->port = 0;
#ifdef CONFIG_EMMC_SUPPORT
#ifdef CONFIG_EMMC_PORThost->port = CONFIG_EMMC_PORT;
#endif
#endifsprintf(mmc->name, DRIVER_NAME);mmc->send_cmd = hi_mci_request;//发送命令回调mmc->set_ios = hi_mci_set_ios;mmc->init = hi_mci_init;//初始化回调mmc->host_caps = MMC_MODE_HS | MMC_MODE_HS_52MHz| MMC_MODE_4BIT | MMC_MODE_8BIT;mmc->voltages = MMC_VDD_32_33 | MMC_VDD_33_34;//电压值范围mmc->f_min = MMC_CCLK_MIN;mmc->f_max = MMC_CCLK_MAX;
#ifdef CONFIG_HIMCI_V200mmc->is_init = 0;
#endifmmc_register(mmc);//注册mmcadd_shutdown(himci_shutdown);//关机回调return 0;
}
重要的两个结构体struct mmc和struct himci_host ;
struct himci_host {struct mmc mmc;unsigned long base;//基地址unsigned int card_status;//卡状态(插入/拔出)unsigned int dev_id;//设备编号idunsigned int port;int cmd_id;struct mmc_cmd *cmd;struct himci_dma_des *dma_des;
};
mmc结构体其中几个变量对应下面sd卡协议中的寄存器;
struct mmc {
#ifdef CONFIG_HIMCI_V200int is_init;
#endifstruct list_head link;char name[32];//名字void *priv;//私有指针uint voltages;//电压值uint version;//版本号uint f_min;uint f_max;int high_capacity;//最高容量uint bus_width;//总线宽度uint clock;//时钟uint card_caps;//卡容量uint host_caps;uint ocr; //操作条件寄存器; 32bituint scr[2];//sd卡配置寄存器;有关sd存储卡特殊功能的信息;64bituint csd[4];//卡特定数据;有关卡操作条件的信息; 128bituint cid[4];//卡片识别号:用于识别的卡片个人编号; 128bitushort rca;//相对卡地址;卡的本地系统地址,由卡动态建议并在初始化期间由主机批准;16bituint tran_speed;//传输速度uint read_bl_len;uint write_bl_len;u64 capacity;block_dev_desc_t block_dev;int (*send_cmd)(struct mmc *mmc,struct mmc_cmd *cmd, struct mmc_data *data);void (*set_ios)(struct mmc *mmc);int (*init)(struct mmc *mmc);
};
OCR寄存器:
其中0~23为电压范围;
bit30位:卡容量状态位,当卡为大容量内存卡时,该位为1; 当卡为标准内存卡时,该位为0;卡容量状态位在卡上电过程完成且卡上电状态位设置为1后生效;
Bit31位:卡上电状态位,若上电状态完成,设置为1;
CID寄存器
卡标识寄存器,128bit; 包含了卡标识信息在卡识别阶段使用; 每个读写卡应该具有唯一的识别号;
对应结构体为struct mmc_cid;
struct mmc_cid {unsigned long psn; //产品序列号unsigned short oid;//一个2字符ASCII字符串,用于标识卡OEM和/或卡内容unsigned char mid;//制造商IDunsigned char prv;//产品修订版unsigned char mdt;//制造日期char pnm[7];//产品名称
};
CSD寄存器
卡特定数据寄存器提供有关访问卡内容的信息;定义了数据格式,纠错类型,最大数据访问时间,DSR寄存器寄存器的寄存器可编程部分可由CMD27更改;
TAAC
定义数据访问时间的异步部分;
NSAC
定义数据访问时间的时钟相关因素的最坏情况。NSAC的单位是100时钟周期。因此,数据访问时间的时钟相关部分的最大值是25.5k个时钟周期。
总访问时间NAC是TAAC和NSAC的总和。它应由主机根据实际时钟速率进行计算。读取访问时间应被解释为数据块或流的第一数据位的典型延迟。
TRAN_SPPED
定义了每一个数据行的最大传输速率;
CCC
SD存储卡命令集分为多个子集(命令类); CCC中的值为1bit表示支持相应的命令类;
READ_BL_LEN
最大读取数据长度计算为2的read_bl_len次方;
READ_BL_PARTIAL
SD存储卡中始终允许部分块读取;意味着可以使用最小的块,最小块为一个字节;
WRITE_BLK_MISALIGN/READ_BLK_MISALIGN
定义由一个命令写入/读的数据块是否可以分布在多个物理块上存储设备的块;内存块的大小在WRITE_BL_LEN/READ_BL_LEN中定义; =0表示跨越物理块边界无效; =1表示允许跨越物理块边界;
DSR_IMP
定义可配置驱动程序阶段是否集成在卡上。=0表未被实施 =1表示已实施;
C_SIZE
此参数用于计算用户的数据卡容量;
VDD_R_CURR_MIN, VDD_W_CURR_MIN
最小电源VDD处的读取和写入电流的最大值编码如下;
VDD_R_CURR_MAX, VDD_W_CURR_MAX
最大电源V DD处的读和写电流的最大值编码;
C_SIZE_MULT
此参数用于编码因子MULT,以计算总设备大小;
MULT = 2的(C_SIZE_MULT+2)次方;
ERASE_BLK_EN
定义要擦除的数据的单位大小的粒度,擦除操作可以擦除512字节的一个或多个单位SECTOR_SIZE;
如果ERASE_BLK_EN=0,主机可以擦除一个或多个SECTOR_SIZE单元。擦除将开始从包含起始地址的扇区的开头到包含结束地址;
如果ERASE_BLK_EN=1,主机可以擦除一个或多个512字节的单元。包含数据的所有块从起始地址到结束地址被擦除;
SECTOR_SIZE
可擦除扇区的大小;
WP_GRP_ENABLE
值为0表示不可能进行组写保护;
R2W_FACTOR
将典型块编程时间定义为读取访问时间的倍数;
WRITE_BL_LEN
最大写入数据块长度计算为2 的write_BL_LEN次方。最大块长度可能因此在512到2048字节的范围内。始终支持512字节的写入块长度。
WRITE_BL_PARTIAL
定义块写入命令中是否可以使用部分块大小。
WRITE_BL_PARTIAL=0表示在512字节单位的分辨率可用于面向块的数据写入。
WRITE_BL_PARTIAL=1表示也可以使用更小的块。最小块大小为1字节;
FILE_FORMAT_GRP
指示选定的文件格式组;
COPY
定义内容是原始(=0)还是已复制(=1);
PERM_WRITE_PROTECT
永久保护整个卡内容不被覆盖或擦除(所有写入和擦除此卡的命令被永久禁用)。默认值为0,即不永久写入受保护的。
TMP_WRITE_PROTECT
暂时保护整个卡内容不被覆盖或擦除(所有写入和擦除此卡的命令暂时禁用)。该位可以设置和重置。默认值为0,即不写保护。
FILE_FORMAT
指示卡上的文件格式;
CRC
CRC字段携带CSD内容的校验和;
uboot中对应结构体如下:
struct mmc_csd
{u8 csd_structure:2,spec_vers:4,rsvd1:2;u8 taac;u8 nsac;u8 tran_speed;u16 ccc:12,read_bl_len:4;u64 read_bl_partial:1,write_blk_misalign:1,read_blk_misalign:1,dsr_imp:1,rsvd2:2,c_size:12,vdd_r_curr_min:3,vdd_r_curr_max:3,vdd_w_curr_min:3,vdd_w_curr_max:3,c_size_mult:3,sector_size:5,erase_grp_size:5,wp_grp_size:5,wp_grp_enable:1,default_ecc:2,r2w_factor:3,write_bl_len:4,write_bl_partial:1,rsvd3:5;u8 file_format_grp:1,copy:1,perm_write_protect:1,tmp_write_protect:1,file_format:2,ecc:2;u8 crc:7;u8 one:1;
};
hi_mci_initialize()函数又调用了mmc_register(mmc);
int mmc_register(struct mmc *mmc)
{
#ifdef CONFIG_HIMCI_V200struct himci_host *host = mmc->priv;
#endif/* Setup the universal parts of the block interface just once */mmc->block_dev.if_type = IF_TYPE_MMC;mmc->block_dev.part_type = PART_TYPE_DOS;
#ifdef CONFIG_HIMCI_V200mmc->block_dev.dev = host->dev_id;
#elsemmc->block_dev.dev = cur_dev_num++;
#endifmmc->block_dev.removable = 1;mmc->block_dev.block_read = mmc_mbread;mmc->block_dev.block_write = mmc_bwrite;INIT_LIST_HEAD (&mmc->link);list_add_tail (&mmc->link, &mmc_devices);//将mmc加入全局mmc设备链表return 0;
}
其中主要初始化block_dev结构体,结构体如下:
typedef struct block_dev_desc {int if_type; /* type of the interface 接口类型*/int dev; /* device number 设备号*/unsigned char part_type; /* partition type 分区类型*/unsigned char target; /* target SCSI ID 目标SCSI ID*/unsigned char lun; /* target LUN 目标LUN*/unsigned char type; /* device type 设备类型*/unsigned char removable; /* removable device 可移动的设备*/
#ifdef CONFIG_LBA48unsigned char lba48; /* device can use 48bit addr (ATA/ATAPI v7) 设备可以使用48bit地址*/
#endiflbaint_t lba; /* number of blocks 块数量*/unsigned long blksz; /* block size 块大小*/char vendor [40+1]; /* IDE model, SCSI Vendor */char product[20+1]; /* IDE Serial no, SCSI product IDE型号,SCSI供应商*/char revision[8+1]; /* firmware revision 固件版本*/unsigned long (*block_read)(int dev,unsigned long start,lbaint_t blkcnt,void *buffer);unsigned long (*block_write)(int dev,//设备号unsigned long start,//块起始地址lbaint_t blkcnt,//块数量const void *buffer);void *priv; /* driver private struct pointer */
}block_dev_desc_t;
其中block_read和block_write回调函数用于块读/写;
两个回调函数都调用了mmc_send_cmd命令;
int mmc_send_cmd(struct mmc *mmc, struct mmc_cmd *cmd, struct mmc_data *data)
{return mmc->send_cmd(mmc, cmd, data);
}
又回调了send_cmd函数, 该函数在最初的hi_mci_initialize函数中被赋值为hi_mci_request;
mmc_send_cmd调用示例:
int mmc_read_block(struct mmc *mmc, void *dst, uint blocknum)
{struct mmc_cmd cmd;struct mmc_data data;cmd.cmdidx = MMC_CMD_READ_SINGLE_BLOCK;if (mmc->high_capacity)cmd.cmdarg = blocknum;elsecmd.cmdarg = blocknum * mmc->read_bl_len;cmd.resp_type = MMC_RSP_R1;cmd.flags = 0;data.dest = dst;data.blocks = 1;data.blocksize = mmc->read_bl_len;data.flags = MMC_DATA_READ;return mmc_send_cmd(mmc, &cmd, &data);
}
其中将cmd和data结构体填充后调用mmc_send_cmd(); 读buf地址被赋值到data.dest处返回;
hi_mci_request()函数中先调用hi_mci_setup_data()准备数据,如将目的地址赋值给dma对应地址等;填充好dma结构体; 然后调用hi_mci_idma_start()开启dma; 完成数据的读/写;
在函数hi_mci_initialize()中还初始化了初始化回调mmc->init = hi_mci_init;
然后在start_armboot中调用mmc_flash_init(0); 该函数最终调用了hi_mci_init();
hi_mci_init()调用了hi_mci_init_card();
static void hi_mci_init_card(struct himci_host *host)
{unsigned int tmp_reg;HIMCI_DEBUG_FUN("Function Call");HIMCI_ASSERT(host);hi_mci_sys_reset(host);/* card reset */himci_writel(~(1<<host->port), host->base + MCI_RESET_N);__udelay(CONFIG_MMC_RESET_LOW_TIMEOUT);/* card power off and power on */hi_mci_ctrl_power(host, POWER_OFF);__udelay(CONFIG_MMC_POWER_OFF_TIMEOUT * 1000);hi_mci_ctrl_power(host, POWER_ON);__udelay(CONFIG_MMC_POWER_ON_TIMEROUT * 1000);/* card reset cancel */himci_writel(1<<host->port, host->base + MCI_RESET_N);__udelay(CONFIG_MMC_RESET_HIGH_TIMEROUT);/* set drv/smpl phase shift 时钟相位*/tmp_reg = himci_readl(host->base + MCI_UHS_REG_EXT);tmp_reg &= ~(DRV_PHASE_MASK | SMPL_PHASE_MASK);tmp_reg |= DRV_PHASE_SHIFT | SMPL_PHASE_SHIFT;himci_writel(tmp_reg, host->base + MCI_UHS_REG_EXT);/* clear MMC host intr MCI_RINTSTS:原始中断状态寄存器*/himci_writel(ALL_INT_CLR, host->base + MCI_RINTSTS);/* MASK MMC host intr MCI_INTMASK:中断屏蔽寄存器*/tmp_reg = himci_readl(host->base + MCI_INTMASK);tmp_reg &= ~ALL_INT_MASK;himci_writel(tmp_reg, host->base + MCI_INTMASK);/* enable inner DMA mode and close intr of MMC host controler */tmp_reg = himci_readl(host->base + MCI_CTRL);tmp_reg &= ~INTR_EN; //全局中断使能 1:=使能tmp_reg |= USE_INTERNAL_DMA;//使用内置DMA搬移数据himci_writel(tmp_reg, host->base + MCI_CTRL);/* enable dma intr */tmp_reg = himci_readl(host->base + MCI_IDINTEN);tmp_reg &= ~MCI_IDINTEN_MASK;tmp_reg = TI | RI | NI;//使能发送接收中断himci_writel(tmp_reg, host->base + MCI_IDINTEN);/* set timeout param [31-8]:卡数据传输超时时间[7-0]:回复超时时间*/himci_writel(DATA_TIMEOUT | RESPONSE_TIMEOUT, host->base + MCI_TIMEOUT);/* set FIFO param */himci_writel(BURST_SIZE | RX_WMARK | TX_WMARK, host->base + MCI_FIFOTH);
}
该函数实现了 (a)复位mmc主机控制器; (b)卡复位 (c)卡掉电后上电 (d)取消卡复位 (e)设置时钟相位 (f)清空mmc主机中断寄存器 (g)设置中断掩码 (h)使能dma模式且关闭mmc主机控制器中断使能;(i)使能dma中断 (j)设置超时参数 (k)设置fifo参数;