mtd_partition.c 文件参考

浏览源代码.

函数
static VOID	YaffsLockInit (VOID)
partition_param *	GetSpinorPartParam (VOID)
mtd_partition *	GetSpinorPartitionHead (VOID)
static VOID	MtdNandParamAssign (partition_param *nandParam, const struct MtdDev *nandMtd)
static VOID	MtdDeinitNandParam (VOID)
	反初始化 更多...
static partition_param *	MtdInitNandParam (partition_param *nandParam)
	nand flash 初始化 更多...
static VOID	MtdNorParamAssign (partition_param *spinorParam, const struct MtdDev *spinorMtd)
	nor flash 初始化,本函数只会被调用一次 更多...
static VOID	MtdDeinitSpinorParam (VOID)
static partition_param *	MtdInitSpinorParam (partition_param *spinorParam)
	spi nor flash 参数初始化 更多...
static INT32	MtdInitFsparParam (const CHAR *type, partition_param **fsparParam)
	根据 flash-type 来初始化分区的参数, Fspar 是不是 flash partition 的意思? 这名字取得有点费解 @note_thinking 更多...
static INT32	MtdDeinitFsparParam (const CHAR *type)
	根据flash-type 去初始化 分区的参数。 更多...
static INT32	AddParamCheck (UINT32 startAddr, const partition_param *param, UINT32 partitionNum, UINT32 length)
	增加MTD分区参数检查 更多...
static INT32	BlockDriverRegisterOperate (mtd_partition *newNode, const partition_param *param, UINT32 partitionNum)
	注册块设备,此函数之后设备将支持VFS访问 更多...
static INT32	CharDriverRegisterOperate (mtd_partition *newNode, const partition_param *param, UINT32 partitionNum)
	注册字符设备,此函数之后设备将支持VFS访问 更多...
static INT32	BlockDriverUnregister (mtd_partition *node)
	注销块设备驱动 更多...
static INT32	CharDriverUnregister (mtd_partition *node)
	注销字符设备驱动 更多...
INT32	add_mtd_partition (const CHAR *type, UINT32 startAddr, UINT32 length, UINT32 partitionNum)
	Add a partition. 更多...
static INT32	DeleteParamCheck (UINT32 partitionNum, const CHAR *type, partition_param **param)
	检查分区参数 更多...
static INT32	DeletePartitionUnregister (mtd_partition *node)
	删除分区驱动程序,注意每个分区的文件系统都可以不一样,驱动程序也都不同 更多...
static INT32	OsNodeGet (mtd_partition **node, UINT32 partitionNum, const partition_param *param)
	获取分区链表节点 更多...
static INT32	OsResourceRelease (mtd_partition *node, const CHAR *type, partition_param *param)
	释放分区链表节点所占内存 sizeof(mtd_partition) 更多...
INT32	delete_mtd_partition (UINT32 partitionNum, const CHAR *type)
	删除MTD分区 更多...

变量
pthread_mutex_t	g_mtdPartitionLock = PTHREAD_MUTEX_INITIALIZER

函数说明

AddParamCheck()

static INT32 AddParamCheck ( UINT32  startAddr, const partition_param *  param, UINT32  partitionNum, UINT32  length  )

static

增加MTD分区参数检查

在文件 mtd_partition.c 第 245 行定义.

{
    UINT32 startBlk, endBlk;
    mtd_partition *node = NULL;
    if ((param->blockname == NULL) && (param->charname == NULL)) {//块/字符设备名称至少有一个
        return -EINVAL;
    }
 
    if ((length == 0) || (length < param->block_size) ||
        (((UINT64)(startAddr) + length) > param->flash_mtd->size)) {
        return -EINVAL;
    }
 
    ALIGN_ASSIGN(length, startAddr, startBlk, endBlk, param->block_size);
 
    if (startBlk > endBlk) {
        return -EINVAL;
    }
    LOS_DL_LIST_FOR_EACH_ENTRY(node, &param->partition_head->node_info, mtd_partition, node_info) {//遍历分区节点
        if ((node->start_block != 0) && (node->patitionnum == partitionNum)) {
            return -EINVAL;
        }
        if ((startBlk > node->end_block) || (endBlk < node->start_block)) {
            continue;
        }
        return -EINVAL;
    }
 
    return ENOERR;
}

这是这个函数的调用关系图:

BlockDriverRegisterOperate()

static INT32 BlockDriverRegisterOperate ( mtd_partition *  newNode, const partition_param *  param, UINT32  partitionNum  )

static

注册块设备,此函数之后设备将支持VFS访问

在文件 mtd_partition.c 第 279 行定义.

{
    INT32 ret;
    size_t driverNameSize;
 
    if (param->blockname != NULL) {
        driverNameSize = strlen(param->blockname) + DRIVER_NAME_ADD_SIZE; // 设备名称长度增加3个字节
        newNode->blockdriver_name = (CHAR *)malloc(driverNameSize);
        if (newNode->blockdriver_name == NULL) {
            return -ENOMEM;
        }
 
        ret = snprintf_s(newNode->blockdriver_name, driverNameSize,
            driverNameSize - 1, "%s%u", param->blockname, partitionNum);
        if (ret < 0) {
            free(newNode->blockdriver_name);
            newNode->blockdriver_name = NULL;
            return -ENAMETOOLONG;
        }
        //在伪文件系统中注册块驱动程序,对节点数据以块方式访问
        ret = register_blockdriver(newNode->blockdriver_name, param->flash_ops,
            RWE_RW_RW, newNode);
        if (ret) {
            free(newNode->blockdriver_name);
            newNode->blockdriver_name = NULL;
            PRINT_ERR("register blkdev partition error\n");
            return ret;
        }
    } else {
        newNode->blockdriver_name = NULL;
    }
    return ENOERR;
}

函数调用图:

这是这个函数的调用关系图:

BlockDriverUnregister()

static INT32 BlockDriverUnregister ( mtd_partition *  node )

static

注销块设备驱动

在文件 mtd_partition.c 第 350 行定义.

{
    INT32 ret;
 
    if (node->blockdriver_name != NULL) {
        ret = unregister_blockdriver(node->blockdriver_name);
        if (ret == -EBUSY) {
            PRINT_ERR("unregister blkdev partition error:%d\n", ret);
            return ret;
        }
        free(node->blockdriver_name);
        node->blockdriver_name = NULL;
    }
    return ENOERR;
}

函数调用图:

这是这个函数的调用关系图:

CharDriverRegisterOperate()

static INT32 CharDriverRegisterOperate ( mtd_partition *  newNode, const partition_param *  param, UINT32  partitionNum  )

static

注册字符设备,此函数之后设备将支持VFS访问

在文件 mtd_partition.c 第 315 行定义.

{
    INT32 ret;
    size_t driverNameSize;
 
    if (param->charname != NULL) {
        driverNameSize = strlen(param->charname) + DRIVER_NAME_ADD_SIZE;
        newNode->chardriver_name = (CHAR *)malloc(driverNameSize);
        if (newNode->chardriver_name == NULL) {
            return -ENOMEM;
        }
 
        ret = snprintf_s(newNode->chardriver_name, driverNameSize,
            driverNameSize - 1, "%s%u", param->charname, partitionNum);
        if (ret < 0) {
            free(newNode->chardriver_name);
            newNode->chardriver_name = NULL;
            return -ENAMETOOLONG;
        }
        //在伪文件系统中注册字符驱动程序,以字符设备的方式访问数据
        ret = register_driver(newNode->chardriver_name, param->char_ops, RWE_RW_RW, newNode);
        if (ret) {
            PRINT_ERR("register chardev partition error\n");
            free(newNode->chardriver_name);
            newNode->chardriver_name = NULL;
            return ret;
        }
    } else {
        newNode->chardriver_name = NULL;
    }
    return ENOERR;
}

函数调用图:

这是这个函数的调用关系图:

CharDriverUnregister()

static INT32 CharDriverUnregister ( mtd_partition *  node )

static

注销字符设备驱动

在文件 mtd_partition.c 第 366 行定义.

{
    INT32 ret;
 
    if (node->chardriver_name != NULL) {
        ret = unregister_driver(node->chardriver_name);
        if (ret == -EBUSY) {
            PRINT_ERR("unregister chardev partition error:%d\n", ret);
            return ret;
        }
        free(node->chardriver_name);//名称占用的内核空间,所以必须释放.
        node->chardriver_name = NULL;
    }
 
    return ENOERR;
}

函数调用图:

这是这个函数的调用关系图:

DeleteParamCheck()

static INT32 DeleteParamCheck ( UINT32  partitionNum, const CHAR *  type, partition_param **  param  )

static

检查分区参数

在文件 mtd_partition.c 第 456 行定义.

{
    if (strcmp(type, "nand") == 0) {
        *param = g_nandPartParam;
    } else if (strcmp(type, "spinor") == 0 || strcmp(type, "cfi-flash") == 0) {
        *param = g_spinorPartParam;
    } else {
        PRINT_ERR("type error \n");
        return -EINVAL;
    }
 
    if ((partitionNum >= CONFIG_MTD_PATTITION_NUM) ||
        ((*param) == NULL) || ((*param)->flash_mtd == NULL)) {
        return -EINVAL;
    }
    return ENOERR;
}

这是这个函数的调用关系图:

DeletePartitionUnregister()

static INT32 DeletePartitionUnregister ( mtd_partition *  node )

static

删除分区驱动程序,注意每个分区的文件系统都可以不一样,驱动程序也都不同

在文件 mtd_partition.c 第 476 行定义.

{
    INT32 ret;
 
    ret = BlockDriverUnregister(node);//注销块设备驱动程序
    if (ret == -EBUSY) {
        return ret;
    }
 
    ret = CharDriverUnregister(node);//注销字符设备驱动程序
    if (ret == -EBUSY) {
        return ret;
    }
 
    return ENOERR;
}

函数调用图:

这是这个函数的调用关系图:

GetSpinorPartitionHead()

mtd_partition * GetSpinorPartitionHead

(

VOID

)

在文件 mtd_partition.c 第 86 行定义.

{
    return g_spinorPartitionHead;
}

GetSpinorPartParam()

partition_param * GetSpinorPartParam

(

VOID

)

在文件 mtd_partition.c 第 81 行定义.

{
    return g_spinorPartParam;
}

这是这个函数的调用关系图:

MtdDeinitFsparParam()

static INT32 MtdDeinitFsparParam ( const CHAR *  type )

static

根据flash-type 去初始化 分区的参数。

在文件 mtd_partition.c 第 230 行定义.

{
    if (strcmp(type, "nand") == 0) {
        MtdDeinitNandParam();//去初始化(析构) Nand flash 参数
        g_nandPartParam = NULL;
    } else if (strcmp(type, "spinor") == 0 || strcmp(type, "cfi-flash") == 0) {
        MtdDeinitSpinorParam();//去初始化(析构) Nor flash 参数, 注 : .h 文件有 spi 和 cfi 的区别介绍
        g_spinorPartParam = NULL;
    } else {
        return -EINVAL;
    }
 
    return ENOERR;
}

函数调用图:

这是这个函数的调用关系图:

MtdDeinitNandParam()

static VOID MtdDeinitNandParam ( VOID  )

static

反初始化

在文件 mtd_partition.c 第 108 行定义.

{
    if (YaffsLockDeinit != NULL) {
        YaffsLockDeinit();
    }
}

这是这个函数的调用关系图:

MtdDeinitSpinorParam()

static VOID MtdDeinitSpinorParam ( VOID  )

static

在文件 mtd_partition.c 第 166 行定义.

{
    if (Jffs2LockDeinit != NULL) {
        Jffs2LockDeinit();
    }
}

这是这个函数的调用关系图:

MtdInitFsparParam()

static INT32 MtdInitFsparParam ( const CHAR *  type, partition_param **  fsparParam  )

static

根据 flash-type 来初始化分区的参数, Fspar 是不是 flash partition 的意思? 这名字取得有点费解 @note_thinking

在文件 mtd_partition.c 第 210 行定义.

{
    if (strcmp(type, "nand") == 0) {// nand flash 的处理
        g_nandPartParam = MtdInitNandParam(g_nandPartParam);//初始化全局变量
        *fsparParam = g_nandPartParam;//参数接走全局变量
    } else if (strcmp(type, "spinor") == 0 || strcmp(type, "cfi-flash") == 0) { //nor flash的处理
        g_spinorPartParam = MtdInitSpinorParam(g_spinorPartParam);//初始化全局变量
        *fsparParam = g_spinorPartParam;//参数接走全局变量
    } else {
        return -EINVAL;
    }
 
    if ((*fsparParam == NULL) || ((VOID *)((*fsparParam)->flash_mtd) == NULL)) {
        return -ENODEV;
    }
 
    return ENOERR;
}

函数调用图:

这是这个函数的调用关系图:

MtdInitNandParam()

static partition_param * MtdInitNandParam ( partition_param *  nandParam )

static

nand flash 初始化

在文件 mtd_partition.c 第 115 行定义.

{
    struct MtdDev *nandMtd = GetMtd("nand");
    if (nandMtd == NULL) {
        return NULL;
    }
    if (nandParam == NULL) {
        if (YaffsLockInit != NULL) {
            YaffsLockInit(); //加锁
        }
        nandParam = (partition_param *)zalloc(sizeof(partition_param));
        if (nandParam == NULL) {
            MtdDeinitNandParam();
            return NULL;
        }
        g_nandPartitionHead = (mtd_partition *)zalloc(sizeof(mtd_partition));
        if (g_nandPartitionHead == NULL) {
            MtdDeinitNandParam();
            free(nandParam);
            return NULL;
        }
 
        MtdNandParamAssign(nandParam, nandMtd);
    }
 
    return nandParam;
}

函数调用图:

这是这个函数的调用关系图:

MtdInitSpinorParam()

static partition_param * MtdInitSpinorParam ( partition_param *  spinorParam )

static

spi nor flash 参数初始化

在文件 mtd_partition.c 第 173 行定义.

{
#ifndef LOSCFG_PLATFORM_QEMU_ARM_VIRT_CA7 //
    struct MtdDev *spinorMtd = GetMtd("spinor");
#else
    struct MtdDev *spinorMtd = GetCfiMtdDev();
#endif
    if (spinorMtd == NULL) {
        return NULL;
    }
    if (spinorParam == NULL) {
        if (Jffs2LockInit != NULL) {
            if (Jffs2LockInit() != 0) { /* create jffs2 lock failed */
                return NULL;
            }
        }
        spinorParam = (partition_param *)zalloc(sizeof(partition_param));
        if (spinorParam == NULL) {
            PRINT_ERR("%s, partition_param malloc failed\n", __FUNCTION__);
            MtdDeinitSpinorParam();
            return NULL;
        }
        g_spinorPartitionHead = (mtd_partition *)zalloc(sizeof(mtd_partition));
        if (g_spinorPartitionHead == NULL) {
            PRINT_ERR("%s, mtd_partition malloc failed\n", __FUNCTION__);
            MtdDeinitSpinorParam();
            free(spinorParam);
            return NULL;
        }
 
        MtdNorParamAssign(spinorParam, spinorMtd);
    }
 
    return spinorParam;
}

函数调用图:

这是这个函数的调用关系图:

MtdNandParamAssign()

static VOID MtdNandParamAssign ( partition_param *  nandParam, const struct MtdDev *  nandMtd  )

static

在文件 mtd_partition.c 第 92 行定义.

{
    LOS_ListInit(&g_nandPartitionHead->node_info);//初始化全局链表
    /*
     * If the user do not want to use block mtd or char mtd ,
     * you can change the NANDBLK_NAME or NANDCHR_NAME to NULL.
     */
    nandParam->flash_mtd = (struct MtdDev *)nandMtd;
    nandParam->flash_ops = GetDevNandOps(); //获取块设备操作方法
    nandParam->char_ops = GetMtdCharFops(); //获取字符设备操作方法
    nandParam->blockname = NANDBLK_NAME;    // /dev/nandblk
    nandParam->charname = NANDCHR_NAME;     // /dev/nandchr
    nandParam->partition_head = g_nandPartitionHead;//头分区节点
    nandParam->block_size = nandMtd->eraseSize;//4K
}

函数调用图:

这是这个函数的调用关系图:

MtdNorParamAssign()

static VOID MtdNorParamAssign ( partition_param *  spinorParam, const struct MtdDev *  spinorMtd  )

static

nor flash 初始化,本函数只会被调用一次

在文件 mtd_partition.c 第 143 行定义.

{
    LOS_ListInit(&g_spinorPartitionHead->node_info);//初始化全局链表,所有spi nor 分区节点都将挂上来
    /*
     * If the user do not want to use block mtd or char mtd ,
     * you can change the SPIBLK_NAME or SPICHR_NAME to NULL.
     *///如果用户不想使用 block mtd 或 char mtd ，您可以将 SPIBLK_NAME 或 SPICHR_NAME 更改为 NULL。
    spinorParam->flash_mtd = (struct MtdDev *)spinorMtd;
#ifndef LOSCFG_PLATFORM_QEMU_ARM_VIRT_CA7 //QEMU开关
    spinorParam->flash_ops = GetDevSpinorOps();//块操作
    spinorParam->char_ops = GetMtdCharFops();//字符操作
    spinorParam->blockname = SPIBLK_NAME;
    spinorParam->charname = SPICHR_NAME;
#else
    spinorParam->flash_ops = GetCfiBlkOps();
    spinorParam->char_ops = NULL;
    spinorParam->blockname = CFI_DRIVER;
    spinorParam->charname = NULL;
#endif
    spinorParam->partition_head = g_spinorPartitionHead;//头分区节点
    spinorParam->block_size = spinorMtd->eraseSize;//4K, 读/写/擦除 的最小单位
}

函数调用图:

这是这个函数的调用关系图:

OsNodeGet()

static INT32 OsNodeGet ( mtd_partition **  node, UINT32  partitionNum, const partition_param *  param  )

static

获取分区链表节点

在文件 mtd_partition.c 第 493 行定义.

{   //遍历链表
    LOS_DL_LIST_FOR_EACH_ENTRY(*node, &param->partition_head->node_info, mtd_partition, node_info) {
        if ((*node)->patitionnum == partitionNum) {//找到分区ID
            break;
        }
    }
    if ((*node == NULL) || ((*node)->patitionnum != partitionNum) ||
        ((*node)->mountpoint_name != NULL)) {
        return -EINVAL;
    }
 
    return ENOERR;
}

这是这个函数的调用关系图:

OsResourceRelease()

static INT32 OsResourceRelease ( mtd_partition *  node, const CHAR *  type, partition_param *  param  )

static

释放分区链表节点所占内存 sizeof(mtd_partition)

在文件 mtd_partition.c 第 508 行定义.

{
    (VOID)LOS_MuxDestroy(&node->lock);
    LOS_ListDelete(&node->node_info);//将自己摘掉
    (VOID)memset_s(node, sizeof(mtd_partition), 0, sizeof(mtd_partition));
    free(node);
    (VOID)FreeMtd(param->flash_mtd);//释放MTD
    if (LOS_ListEmpty(&param->partition_head->node_info)) {//如果是最后一个
        free(param->partition_head);//释放头节点内存
        param->partition_head = NULL;
        free(param);
 
        if (MtdDeinitFsparParam(type) != ENOERR) {
            return -EINVAL;
        }
    }
    return ENOERR;
}

函数调用图:

这是这个函数的调用关系图:

YaffsLockInit()

static VOID YaffsLockInit ( VOID  )

static

在文件 mtd_partition.c 第 64 行定义.

{
    return g_nandPartParam;
}

这是这个函数的调用关系图:

变量说明

g_mtdPartitionLock

pthread_mutex_t g_mtdPartitionLock = PTHREAD_MUTEX_INITIALIZER

在文件 mtd_partition.c 第 48 行定义.