133 lines
4.5 KiB
C
133 lines
4.5 KiB
C
/*----------------------------------------------------------------------------
|
|
* Tencent is pleased to support the open source community by making TencentOS
|
|
* available.
|
|
*
|
|
* Copyright (C) 2019 THL A29 Limited, a Tencent company. All rights reserved.
|
|
* If you have downloaded a copy of the TencentOS binary from Tencent, please
|
|
* note that the TencentOS binary is licensed under the BSD 3-Clause License.
|
|
*
|
|
* If you have downloaded a copy of the TencentOS source code from Tencent,
|
|
* please note that TencentOS source code is licensed under the BSD 3-Clause
|
|
* License, except for the third-party components listed below which are
|
|
* subject to different license terms. Your integration of TencentOS into your
|
|
* own projects may require compliance with the BSD 3-Clause License, as well
|
|
* as the other licenses applicable to the third-party components included
|
|
* within TencentOS.
|
|
*---------------------------------------------------------------------------*/
|
|
|
|
#ifndef _TOS_MMBLK_H_
|
|
#define _TOS_MMBLK_H_
|
|
|
|
__CDECLS_BEGIN
|
|
|
|
#define K_MMBLK_NEXT_BLK(blk_curr, blk_size) ((void *)((cpu_addr_t)blk_curr + blk_size))
|
|
#define K_MMBLK_ALIGN_MASK (sizeof(void *) - 1u)
|
|
|
|
typedef struct k_mmblk_pool_st {
|
|
knl_obj_t knl_obj;
|
|
|
|
void *pool_start;
|
|
void *free_list;
|
|
size_t blk_size;
|
|
size_t blk_max;
|
|
size_t blk_free;
|
|
} k_mmblk_pool_t;
|
|
|
|
/**
|
|
* @brief Create a memory manage block pool.
|
|
* Create a memory manage block pool.
|
|
*
|
|
* @attention None
|
|
*
|
|
* @param[in] mbp pointer to the memory block pool handler.
|
|
* @param[in] pool_start start address of the pool.
|
|
* @param[in] blk_num number of the blocks in the pool.
|
|
* @param[in] blk_size size of each block in the pool.
|
|
*
|
|
* @return errcode
|
|
* @retval #K_ERR_MMBLK_INVALID_POOL_ADDR start address of the pool is invalid.
|
|
* @retval #K_ERR_MMBLK_INVALID_BLK_SIZE size of the block is invalid.
|
|
* @retval #K_ERR_NONE return successfully.
|
|
*/
|
|
__API__ k_err_t tos_mmblk_pool_create(k_mmblk_pool_t *mbp, void *pool_start, size_t blk_num, size_t blk_size);
|
|
|
|
/**
|
|
* @brief Destroy a memory manage block pool.
|
|
* Destroy a memory manage block pool.
|
|
*
|
|
* @attention None
|
|
*
|
|
* @param[in] mbp pointer to the memory block pool handler.
|
|
*
|
|
* @return errcode
|
|
* @retval #K_ERR_OBJ_INVALID mbp is not a valid memory block pool handler.
|
|
* @retval #K_ERR_NONE return successfully.
|
|
*/
|
|
__API__ k_err_t tos_mmblk_pool_destroy(k_mmblk_pool_t *mbp);
|
|
|
|
/**
|
|
* @brief Create a dynamic memory manage block pool.
|
|
* Create a dynamic memory manage block pool.
|
|
*
|
|
* @attention None
|
|
*
|
|
* @param[in] mbp pointer to the pointer of memory block pool handler.
|
|
* @param[in] blk_num number of the blocks in the pool.
|
|
* @param[in] blk_size size of each block in the pool.
|
|
*
|
|
* @return errcode
|
|
* @retval #K_ERR_MMBLK_INVALID_POOL_ADDR start address of the pool is invalid.
|
|
* @retval #K_ERR_MMBLK_INVALID_BLK_SIZE size of the block is invalid.
|
|
* @retval #K_ERR_NONE return successfully.
|
|
*/
|
|
__API__ k_err_t tos_mmblk_pool_create_dyn(k_mmblk_pool_t **mbp, size_t blk_num, size_t blk_size);
|
|
|
|
/**
|
|
* @brief Destroy a dynamic memory manage block pool.
|
|
* Destroy a memory dynamic manage block pool.
|
|
*
|
|
* @attention None
|
|
*
|
|
* @param[in] mbp pointer to the memory block pool handler.
|
|
*
|
|
* @return errcode
|
|
* @retval #K_ERR_OBJ_INVALID mbp is not a valid memory block pool handler.
|
|
* @retval #K_ERR_NONE return successfully.
|
|
*/
|
|
__API__ k_err_t tos_mmblk_pool_destroy_dyn(k_mmblk_pool_t *mbp);
|
|
|
|
/**
|
|
* @brief Allocate a memory manage block.
|
|
* Allocate a memory manage block.
|
|
*
|
|
* @attention None
|
|
*
|
|
* @param[in] mbp pointer to the memory block pool handler.
|
|
* @param[in] blk start address of the memory manage block.
|
|
*
|
|
* @return errcode
|
|
* @retval #K_ERR_MMBLK_POOL_EMPTY the pool is empty.
|
|
* @retval #K_ERR_NONE return successfully.
|
|
*/
|
|
__API__ k_err_t tos_mmblk_alloc(k_mmblk_pool_t *mbp, void **blk);
|
|
|
|
/**
|
|
* @brief Free a memory manage block.
|
|
* Free a memory manage block.
|
|
*
|
|
* @attention None
|
|
*
|
|
* @param[in] mbp pointer to the memory block pool handler.
|
|
* @param[in] blk start address of the memory manage block.
|
|
*
|
|
* @return errcode
|
|
* @retval #K_ERR_MMBLK_POOL_FULL the pool is full.
|
|
* @retval #K_ERR_NONE return successfully.
|
|
*/
|
|
__API__ k_err_t tos_mmblk_free(k_mmblk_pool_t *mbp, void *blk);
|
|
|
|
#endif
|
|
|
|
__CDECLS_END
|
|
|