📄 lib_mem.c
字号:
p1_mem_08--;
p2_mem_08--;
if (*p1_mem_08 != *p2_mem_08) { /* If ANY data octet(s) NOT identical, cmp fails. */
mem_cmp = DEF_NO;
}
size_rem -= sizeof(CPU_INT08U);
}
return (mem_cmp);
}
/*$PAGE*/
/*
*********************************************************************************************************
* Mem_HeapAlloc()
*
* Description : Allocate a memory block from the heap memory pool.
*
* Argument(s) : size Size of memory block to allocate (in octets).
*
* align Alignment of memory block to specific word boundary (in octets).
*
* poctets_reqd Optional pointer to a variable to ... :
*
* (a) Return the number of octets required to successfully
* allocate the memory block, if any error(s);
* (b) Return 0, otherwise.
*
* perr Pointer to variable that will receive the return error code from this function :
*
* LIB_MEM_ERR_NONE Memory block successfully returned.
* LIB_MEM_ERR_INVALID_MEM_SIZE Invalid memory size.
* LIB_MEM_ERR_INVALID_MEM_ALIGN Invalid memory alignment.
* LIB_MEM_ERR_HEAP_EMPTY Heap segment empty; NOT enough available
* memory from heap.
* LIB_MEM_ERR_HEAP_OVF Requested memory overflows heap memory.
*
* Return(s) : Pointer to memory block, if NO error(s).
*
* Pointer to NULL, otherwise.
*
* Caller(s) : Application.
*
* Note(s) : (1) Pointers to variables that return values MUST be initialized PRIOR to all other
* validation or function handling in case of any error(s).
*
* (2) 'pmem_pool' variables MUST ALWAYS be accessed exclusively in critical sections.
*********************************************************************************************************
*/
/*$PAGE*/
#if (LIB_MEM_CFG_ALLOC_EN == DEF_ENABLED)
void *Mem_HeapAlloc (CPU_SIZE_T size,
CPU_SIZE_T align,
CPU_SIZE_T *poctets_reqd,
LIB_ERR *perr)
{
MEM_POOL *pmem_pool_heap;
void *pmem_addr;
void *pmem_blk;
CPU_SIZE_T octets_reqd_unused;
CPU_SIZE_T size_rem;
CPU_SIZE_T size_req;
CPU_SR_ALLOC();
#if (LIB_MEM_CFG_ARG_CHK_EXT_EN == DEF_ENABLED) /* ------------- VALIDATE RTN ERR PTR ------------- */
if (perr == (LIB_ERR *)0) {
CPU_SW_EXCEPTION((void *)0);
}
#endif
/* ------------ VALIDATE RTN OCTETS PTR ----------- */
if (poctets_reqd == (CPU_SIZE_T *) 0) { /* If NOT avail, ... */
poctets_reqd = (CPU_SIZE_T *)&octets_reqd_unused; /* ... re-cfg NULL rtn ptr to unused local var. */
(void)&octets_reqd_unused; /* Prevent possible 'variable unused' warning. */
}
*poctets_reqd = 0u; /* Init octets req'd for err (see Note #1). */
#if (LIB_MEM_CFG_ARG_CHK_EXT_EN == DEF_ENABLED) /* ------------ VALIDATE HEAP MEM ALLOC ----------- */
if (size < 1) {
*perr = LIB_MEM_ERR_INVALID_MEM_SIZE;
return ((void *)0);
}
if (align < 1) {
*perr = LIB_MEM_ERR_INVALID_MEM_ALIGN;
return ((void *)0);
}
#endif
/* -------------- ALLOC HEAP MEM BLK -------------- */
pmem_pool_heap = &Mem_PoolHeap;
CPU_CRITICAL_ENTER();
pmem_addr = pmem_pool_heap->SegAddrNextAvail;
size_rem = pmem_pool_heap->SegSizeRem;
size_req = Mem_PoolSegCalcTotSize(pmem_addr,
1u, /* Calc alloc for single mem blk from heap. */
size,
align);
#if (LIB_MEM_CFG_ARG_CHK_EXT_EN == DEF_ENABLED)
if (size_req < 1) { /* If req'd size ovf, ... */
CPU_CRITICAL_EXIT();
*poctets_reqd = size; /* ... rtn add'l heap size needed. */
*perr = LIB_MEM_ERR_HEAP_OVF;
return ((void *)0);
}
#endif
if (size_req > size_rem) { /* If req'd size > rem heap size, ... */
CPU_CRITICAL_EXIT();
*poctets_reqd = size_req - size_rem; /* ... rtn add'l heap size needed. */
*perr = LIB_MEM_ERR_HEAP_EMPTY;
return ((void *)0);
}
pmem_blk = Mem_PoolSegAlloc(pmem_pool_heap, size, align);
if (pmem_blk == (void *)0) { /* If mem blk NOT avail from heap, ... */
CPU_CRITICAL_EXIT();
*poctets_reqd = size_req; /* ... rtn add'l heap size needed. */
*perr = LIB_MEM_ERR_HEAP_EMPTY;
return ((void *)0);
}
CPU_CRITICAL_EXIT();
*perr = LIB_MEM_ERR_NONE;
return (pmem_blk);
}
#endif
/*$PAGE*/
/*
*********************************************************************************************************
* Mem_PoolClr()
*
* Description : Clear a memory pool (see Note #1).
*
* Argument(s) : pmem_pool Pointer to a memory pool structure to clear (see Note #2).
*
* perr Pointer to variable that will receive the return error code from this function :
*
* LIB_MEM_ERR_NONE Memory pool successfully cleared.
* LIB_MEM_ERR_NULL_PTR Argument 'pmem_pool' passed a NULL pointer.
*
* Return(s) : none.
*
* Caller(s) : Application,
* Mem_PoolCreate().
*
* Note(s) : (1) (a) Mem_PoolClr() ONLY clears a memory pool structure's variables & should ONLY be
* called to initialize a memory pool structure prior to calling Mem_PoolCreate().
*
* (b) Mem_PoolClr() does NOT deallocate memory from the memory pool or deallocate the
* memory pool itself & MUST NOT be called after calling Mem_PoolCreate() since
* this will likely corrupt the memory pool management.
*
* (2) Assumes 'pmem_pool' points to a valid memory pool (if non-NULL).
*********************************************************************************************************
*/
#if (LIB_MEM_CFG_ALLOC_EN == DEF_ENABLED)
void Mem_PoolClr (MEM_POOL *pmem_pool,
LIB_ERR *perr)
{
#if (LIB_MEM_CFG_ARG_CHK_EXT_EN == DEF_ENABLED) /* -------------- VALIDATE RTN ERR PTR --------------- */
if (perr == (LIB_ERR *)0) {
CPU_SW_EXCEPTION(;);
}
#endif
/* -------------- VALIDATE MEM POOL PTR --------------- */
if (pmem_pool == (MEM_POOL *)0) {
*perr = LIB_MEM_ERR_NULL_PTR;
return;
}
pmem_pool->Type = (LIB_MEM_TYPE)LIB_MEM_TYPE_NONE;
pmem_pool->SegPrevPtr = (MEM_POOL *)0;
pmem_pool->SegNextPtr = (MEM_POOL *)0;
pmem_pool->PoolPrevPtr = (MEM_POOL *)0;
pmem_pool->PoolNextPtr = (MEM_POOL *)0;
pmem_pool->PoolAddrStart = (void *)0;
pmem_pool->PoolAddrEnd = (void *)0;
pmem_pool->PoolPtrs = (void **)0;
pmem_pool->PoolSize = (CPU_SIZE_T )0u;
pmem_pool->BlkAlign = (CPU_SIZE_T )0u;
pmem_pool->BlkSize = (CPU_SIZE_T )0u;
pmem_pool->BlkNbr = (CPU_SIZE_T )0u;
pmem_pool->BlkIx = (MEM_POOL_IX )0u;
pmem_pool->SegAddr = (void *)0;
pmem_pool->SegAddrNextAvail = (void *)0;
pmem_pool->SegSizeTot = (CPU_SIZE_T )0u;
pmem_pool->SegSizeRem = (CPU_SIZE_T )0u;
*perr = LIB_MEM_ERR_NONE;
}
#endif
/*$PAGE*/
/*
*********************************************************************************************************
* Mem_PoolCreate()
*
* Description : (1) Create a memory pool :
*
* (a) Create memory pool from heap or dedicated memory
* (b) Allocate memory pool memory blocks
* (c) Update memory pool table
* (d) Configure memory pool
*
*
* (2) Memory pools are indexed by the Memory Segments they use.
*
* (a) The memory pool table is composed by a two-dimensional list :
*
* (1) Memory segments manage the following memory segment/pool information :
*
* (A) Memory segment base address
* (B) Memory segment next available address
* (C) Memory segment total size
* (D) Memory segment remaining size
*
* (2) Memory pools share memory from memory segments but do NOT manage any memory
* segment information. To access the memory segment information, the head
* memory segment must be accessed.
*
* (b) In the diagram below, memory pools in vertical columns represent they share the same
* memory segment for the memory blocks they have. The heads of the memory pool are
* linked horizontally to form a memory pool table.
*
* (1) 'Mem_PoolTbl' points to the head of the Memory Pool table.
*
* (2) Memory Pools' 'SegPrevPtr' & 'SegNextPtr' doubly-link each memory segment to
* form the list of memory segments.
*
* (3) Memory Pools' 'PoolPrevPtr' & 'PoolNextPtr' doubly-link the memory pools of
* each memory segment.
*
* (c) New memory pools, which do not share a memory segment, are inserted in the Memory
* Segments Primary List. The point of insertion is such to keep ascended order by
* memory segment base address.
*
* (d) Memory pool pointers to memory blocks 'PoolPtrs' must be allocated for each created
* memory pool. These pointers are stored in the memory pool heap segment 'Mem_PoolHeap'.
*
* (1) A memory pool can also have its memory blocks allocated from the memory pool heap.
* 'pmem_base_addr' must be set to NULL & 'mem_size' must be set to (0) to create the
* memory pool.
*
*
* | |
* |<----------------------- Memory Segments ----------------------->|
* | (see Note #2a1) |
*
* Lowest Memory Segment Highest Memory Segment
* Base Address Base Address
* (see Note #2c) (see Note #2c)
*
* | SegNextPtr Heap Memory Pool |
* | (see Note #2b2) (see Note #2d) |
* | | |
* v | | v
* | v
* --- Head of Memory ------- ------- v ------- ------- -------
* ^ Pool Table --->| |------->| |------->| |------->| |------->| |
* | (see Note #2b1) | | | | | | | H | | |
* | | |<-------| |<-------| |<-------| E |<-------| |
* | | | | | ^ | | | A | | |
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -