p46789105
/
AliOS_Things_Memory_Management
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Delete '带有注解的源代码'

Browse Source
master
p46789105 5 years ago
parent 93d8d12475
commit 6e5449d0a1
1 changed files with 0 additions and 264 deletions
Show Stats Download Patch File Download Diff File

264
带有注解的源代码
Unescape View File

@ -1,264 +0,0 @@
/**
* @file k_mm.h
*
* @copyright Copyright (C) 2015-2019 Alibaba Group Holding Limited
*/
#ifndef K_MM_H
#define K_MM_H
/** @addtogroup aos_rhino mm
* Heap memory management.
*
* @{
*/
#if (RHINO_CONFIG_MM_TLF > 0)
/**
* Heap useage size statistic
*/
#define K_MM_STATISTIC 1
/**
* Memory buffer align to MM_ALIGN_SIZE
*/
#define MM_ALIGN_BIT 3
#define MM_ALIGN_SIZE (1 << MM_ALIGN_BIT)
#define MM_ALIGN_MASK (MM_ALIGN_SIZE - 1)
#define MM_ALIGN_UP(a) (((a) + MM_ALIGN_MASK) & ~MM_ALIGN_MASK)
#define MM_ALIGN_DOWN(a) ((a) & ~MM_ALIGN_MASK)
/**
* Max size of memory buffer
*/
#define MM_MAX_BIT RHINO_CONFIG_MM_MAXMSIZEBIT
#define MM_MAX_SIZE (1 << MM_MAX_BIT)
/**
* Min size of memory buffer
*/
#define MM_MIN_BIT RHINO_CONFIG_MM_MINISIZEBIT
#define MM_MIN_SIZE (1 << (MM_MIN_BIT - 1))
/**
* Size level of memory buffer
*/
#define MM_BIT_LEVEL (MM_MAX_BIT - MM_MIN_BIT + 2)
/**
* Min size of memory heap
*/
#define MIN_FREE_MEMORY_SIZE 1024
/**
* Bit0 of 'k_mm_head.buf_size' indicate this buffer is free or not
*/
#define RHINO_MM_CURSTAT_MASK 0x1
#define RHINO_MM_FREE 1
#define RHINO_MM_ALLOCED 0
/**
* Bit1 of 'k_mm_head.buf_size' indicate the previous buffer is free or not
*/
#define RHINO_MM_PRESTAT_MASK 0x2
#define RHINO_MM_PREVFREE 2
#define RHINO_MM_PREVALLOCED 0
/**
* Buffer head size
*/
#define MMLIST_HEAD_SIZE (MM_ALIGN_UP(sizeof(k_mm_list_t) - sizeof(free_ptr_t)))
/**
* Buffer payload size
*/
#define MM_GET_BUF_SIZE(blk) ((blk)->buf_size & (~MM_ALIGN_MASK))
/**
* Buffer head + payload size
*/
#define MM_GET_BLK_SIZE(blk) (MM_GET_BUF_SIZE(blk) + MMLIST_HEAD_SIZE)
/**
* Get next buffer head addr
*/
#define MM_GET_NEXT_BLK(blk) ((k_mm_list_t *)((blk)->mbinfo.buffer + MM_GET_BUF_SIZE(blk)))
/**
* Get this buffer head addr
*/
#define MM_GET_THIS_BLK(buf) ((k_mm_list_t *)((char *)(buf)-MMLIST_HEAD_SIZE))
#if (RHINO_CONFIG_MM_REGION_MUTEX == 0)
/**
* MM critical section strategy:
* Interrupt mask for single core, and busy-waiting spinlock for multi-core
*/
#define MM_CRITICAL_ENTER(pmmhead,flags_cpsr) krhino_spin_lock_irq_save(&(pmmhead->mm_lock),flags_cpsr);
#define MM_CRITICAL_EXIT(pmmhead,flags_cpsr) krhino_spin_unlock_irq_restore(&(pmmhead->mm_lock),flags_cpsr);
#else
/**
* MM critical section strategy:
* Task blocked
*/
#define MM_CRITICAL_ENTER(pmmhead,flags_cpsr) \
do { \
(void)flags_cpsr; \
CPSR_ALLOC(); \
RHINO_CRITICAL_ENTER(); \
if (g_intrpt_nested_level[cpu_cur_get()] > 0u) { \
k_err_proc(RHINO_NOT_CALLED_BY_INTRPT); \
} \
RHINO_CRITICAL_EXIT(); \
krhino_mutex_lock(&(pmmhead->mm_mutex), RHINO_WAIT_FOREVER); \
} while (0);
#define MM_CRITICAL_EXIT(pmmhead,flags_cpsr) \
do { \
(void)flags_cpsr; \
krhino_mutex_unlock(&(pmmhead->mm_mutex)); \
} while (0);
#endif
/**
* free buffer list
*/ /* 空闲缓存区结点，仅包含内存缓存区头结点类型的前驱和后继 */
typedef struct free_ptr_struct {
struct k_mm_list_struct *prev;
struct k_mm_list_struct *next;
} free_ptr_t;
/**
* memory buffer head
*/ /* 内存buffer列表，包含同类型前驱指针、缓存区size和一个共用体（当buffer为free使用一个空闲缓存去列表，被alloc则使用buffer变量有效载荷） */
typedef struct k_mm_list_struct {
#if (RHINO_CONFIG_MM_DEBUG > 0)
/**<
* Magic word:
* RHINO_MM_FREE_DYE, when buffer is free
* RHINO_MM_CORRUPT_DYE, when buffer is alloced
*/
size_t dye;
size_t owner; /**< buffer alloc owner */
#endif
struct k_mm_list_struct *prev;
/**<
* buffer payload size, and:
* bit 0 indicates whether the block is used and
* bit 1 allows to know whether the previous block is free
*/
size_t buf_size;
union {
free_ptr_t free_ptr; /**< when buffer is free, add to free list */
uint8_t buffer[1]; /**< when buffer is alloced, payload start */
} mbinfo;
} k_mm_list_t;
/**
* memory region info
* Heap can contain multiple regoins
*/ /* 内存区域信息，仅包含一个内存缓冲区列表类型的end指针和自身类型next指针 */
typedef struct k_mm_region_info_struct {
k_mm_list_t *end;
struct k_mm_region_info_struct *next;
} k_mm_region_info_t;
/**
* memory heap info
* heap contains:
* ---------------------------------------------------------------------------
* | k_mm_head | k_mm_list_t | k_mm_region_info_t | free space | k_mm_list_t |
* ---------------------------------------------------------------------------
*/ /* 内存头结点，堆包含五块内容如上 */
typedef struct {
#if (RHINO_CONFIG_MM_REGION_MUTEX > 0)
kmutex_t mm_mutex;
#else
kspinlock_t mm_lock;
#endif
k_mm_region_info_t *regioninfo; /**< Heap can contain multiple regoins */
#if (RHINO_CONFIG_MM_BLK > 0)
void *fix_pool; /**< heap can contain one fix pool, deal with little buffer */
#endif
#if (K_MM_STATISTIC > 0)
size_t used_size;
size_t maxused_size;
size_t free_size;
size_t alloc_times[MM_BIT_LEVEL];
#endif
/**< msb (MM_BIT_LEVEL-1) <-> lsb 0, one bit match one freelist */
uint32_t free_bitmap;
/**<
* freelist[N]: contain free blks at level N,
* 2^(N + MM_MIN_BIT) <= level N buffer size < 2^(1 + N + MM_MIN_BIT)
*/
k_mm_list_t *freelist[MM_BIT_LEVEL];
} k_mm_head;
/**
* internal funcs
*/ /* k_*类型函数是功能函数（内核级），调用k_mm_blk内核函数实现，krhino_*类型函数是接口函数（用户级），调用前者实现功能并暴露给外部使用 */
kstat_t krhino_init_mm_head(k_mm_head **ppmmhead, void *addr, size_t len);
kstat_t krhino_deinit_mm_head(k_mm_head *mmhead);
kstat_t krhino_add_mm_region(k_mm_head *mmhead, void *addr, size_t len);
void *k_mm_alloc(k_mm_head *mmhead, size_t size);
void k_mm_free(k_mm_head *mmhead, void *ptr);
void *k_mm_realloc(k_mm_head *mmhead, void *oldmem, size_t new_size);
/**
* Memory buffer allocation.
*
* @param[in] size size of the mem to malloc
*
* @return buffer address or NULL
*/
void *krhino_mm_alloc(size_t size);
/**
* Memory buffer free.
*
* @param[in] ptr buffer address
*
* @return none
*/
void krhino_mm_free(void *ptr);
/**
* Memory buffer realloc.
*
* @param[in] oldmem oldmem buffer address
* @param[in] newsize size of the mem to malloc
*
* @return buffer address or NULL
*/
void *krhino_mm_realloc(void *oldmem, size_t newsize);
/**
* Get the max free buffer size.
*
* @param[in] NULL
*
* @return the max free buffer size
*/
size_t krhino_mm_max_free_size_get(void);
#else
#include <stdlib.h>
/**
* do not use os heap management
*/
#define krhino_mm_alloc malloc
#define krhino_mm_free free
#define krhino_mm_realloc realloc
#endif /* RHINO_CONFIG_MM_TLF > 0 */
/** @} */
#endif /* K_MM_H */
Write Preview
Loading…
Cancel
Save