Multi Partition

Multi Partition 的协作图:

函数
INT32	add_mtd_partition (const CHAR *type, UINT32 startAddr, UINT32 length, UINT32 partitionNum)
	Add a partition. 更多...
INT32	delete_mtd_partition (UINT32 partitionNum, const CHAR *type)
	Delete a partition. 更多...

详细描述

函数说明

add_mtd_partition()

INT32 add_mtd_partition	(	const CHAR *	type,
		UINT32	startAddr,
		UINT32	length,
		UINT32	partitionNum
	)

Add a partition.

Description:

• This API is used to add a partition according to the passed-in parameters.

注意

• None.

参数

type	[IN] Storage medium type, support "nand" and "spinor" currently.
startAddr	[IN] Starting address of a partition.
length	[IN] Partition size.
partitionNum	[IN] Partition number, less than the value defined by CONFIG_MTD_PATTITION_NUM.

返回值

#-ENODEV	The driver is not found.
#-EINVAL	Invalid parameter.
#-ENOMEM	Insufficient memory.
#ENOERR	The partition is successfully created.

Dependency:

• mtd_partition.h: the header file that contains the API declaration.

参见

delete_mtd_partition

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

{
    INT32 ret;
    mtd_partition *newNode = NULL;
    partition_param *param = NULL;
 
    if ((partitionNum >= CONFIG_MTD_PATTITION_NUM) || (type == NULL)) {
        return -EINVAL;
    }
 
    ret = pthread_mutex_lock(&g_mtdPartitionLock);
    if (ret != ENOERR) {
        PRINT_ERR("%s %d, mutex lock failed, error:%d\n", __FUNCTION__, __LINE__, ret);
    }
 
    ret = MtdInitFsparParam(type, &param);//初始化 flash 分区参数
    if (ret != ENOERR) {
        goto ERROR_OUT;
    }
    //参数检查
    ret = AddParamCheck(startAddr, param, partitionNum, length);
    if (ret != ENOERR) {
        goto ERROR_OUT;
    }
 
    newNode = (mtd_partition *)zalloc(sizeof(mtd_partition));//分配一个分区节点
    if (newNode == NULL) {
        (VOID)pthread_mutex_unlock(&g_mtdPartitionLock);
        return -ENOMEM;
    }
    //分区对齐
    PAR_ASSIGNMENT(newNode, length, startAddr, partitionNum, param->flash_mtd, param->block_size);
    //注册块设备驱动程序
    ret = BlockDriverRegisterOperate(newNode, param, partitionNum);
    if (ret) {
        goto ERROR_OUT1;
    }
    //注册字符设备驱动程序
    ret = CharDriverRegisterOperate(newNode, param, partitionNum);
    if (ret) {
        goto ERROR_OUT2;
    }
 
    LOS_ListTailInsert(&param->partition_head->node_info, &newNode->node_info);//挂到全局分区链表上
    (VOID)LOS_MuxInit(&newNode->lock, NULL);//初始化锁,每个分区节点都有自己的互斥锁
 
    ret = pthread_mutex_unlock(&g_mtdPartitionLock);
    if (ret != ENOERR) {
        PRINT_ERR("%s %d, mutex unlock failed, error:%d\n", __FUNCTION__, __LINE__, ret);
    }
 
    return ENOERR;
ERROR_OUT2:
    (VOID)BlockDriverUnregister(newNode);
ERROR_OUT1:
    free(newNode);
ERROR_OUT:
    (VOID)pthread_mutex_unlock(&g_mtdPartitionLock);
    return ret;
}

函数调用图:

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

delete_mtd_partition()

INT32 delete_mtd_partition	(	UINT32	partitionNum,
		const CHAR *	type
	)

Delete a partition.

Description:

• This API is used to delete a partition according to its partition number and storage medium type.

注意

• None.

参数

partitionNum	[IN] Partition number, less than the value defined by CONFIG_MTD_PATTITION_NUM.
type	[IN] Storage medium type, support "nand" and "spinor" currently.

返回值

#-EINVAL	Invalid parameter.
#ENOERR	The partition is successfully deleted.

Dependency:

• mtd_partition.h: the header file that contains the API declaration.

参见

add_mtd_partition

Delete a partition.

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

{
    INT32 ret;
    mtd_partition *node = NULL;
    partition_param *param = NULL;
 
    if (type == NULL) {
        return -EINVAL;
    }
 
    ret = pthread_mutex_lock(&g_mtdPartitionLock);
    if (ret != ENOERR) {
        PRINT_ERR("%s %d, mutex lock failed, error:%d\n", __FUNCTION__, __LINE__, ret);
    }
 
    ret = DeleteParamCheck(partitionNum, type, &param);//删除操作时的参数检查
    if (ret) {
        PRINT_ERR("delete_mtd_partition param invalid\n");
        (VOID)pthread_mutex_unlock(&g_mtdPartitionLock);
        return ret;
    }
 
    ret = OsNodeGet(&node, partitionNum, param);
    if (ret) {
        (VOID)pthread_mutex_unlock(&g_mtdPartitionLock);
        return ret;
    }
 
    ret = DeletePartitionUnregister(node);
    if (ret) {
        PRINT_ERR("DeletePartitionUnregister error:%d\n", ret);
        (VOID)pthread_mutex_unlock(&g_mtdPartitionLock);
        return ret;
    }
 
    ret = OsResourceRelease(node, type, param);
    if (ret) {
        PRINT_ERR("DeletePartitionUnregister error:%d\n", ret);
        (VOID)pthread_mutex_unlock(&g_mtdPartitionLock);
        return ret;
    }
 
    ret = pthread_mutex_unlock(&g_mtdPartitionLock);
    if (ret != ENOERR) {
        PRINT_ERR("%s %d, mutex unlock failed, error:%d\n", __FUNCTION__, __LINE__, ret);
    }
    return ENOERR;
}

函数调用图:

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