海思uboot&sd卡协议

在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_PORT
    host->port = CONFIG_EMMC_PORT;
#endif
#endif

    sprintf(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_V200
    mmc->is_init = 0;
#endif

    mmc_register(mmc);//注册mmc

    add_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;//设备编号id
    unsigned int        port;
    int            cmd_id;
    struct mmc_cmd        *cmd;
    struct himci_dma_des    *dma_des;
};

mmc结构体其中几个变量对应下面sd卡协议中的寄存器;

struct mmc {
#ifdef CONFIG_HIMCI_V200
    int is_init;
#endif
    struct 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; //操作条件寄存器; 32bit
    uint scr[2];//sd卡配置寄存器;有关sd存储卡特殊功能的信息;64bit
    uint csd[4];//卡特定数据;有关卡操作条件的信息; 128bit
    uint cid[4];//卡片识别号:用于识别的卡片个人编号; 128bit
    ushort rca;//相对卡地址;卡的本地系统地址,由卡动态建议并在初始化期间由主机批准;16bit
    uint 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;//制造商ID
    unsigned 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_V200
    struct 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_V200
    mmc->block_dev.dev = host->dev_id;
#else
    mmc->block_dev.dev = cur_dev_num++;
#endif
    mmc->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_LBA48
    unsigned char    lba48;        /* device can use 48bit addr (ATA/ATAPI v7) 设备可以使用48bit地址*/
#endif
    lbaint_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;
    else
        cmd.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参数;