os_mem.c 文件参考

#include <ucos_ii.h>

os_mem.c 的引用(Include)关系图:

浏览源代码.

函数
OS_MEM *	OSMemCreate (void *addr, INT32U nblks, INT32U blksize, INT8U *perr)
void *	OSMemGet (OS_MEM *pmem, INT8U *perr)
INT8U	OSMemNameGet (OS_MEM *pmem, INT8U **pname, INT8U *perr)
void	OSMemNameSet (OS_MEM *pmem, INT8U *pname, INT8U *perr)
INT8U	OSMemPut (OS_MEM *pmem, void *pblk)
INT8U	OSMemQuery (OS_MEM *pmem, OS_MEM_DATA *p_mem_data)
void	OS_MemInit (void)

函数说明

OS_MEM* OSMemCreate	(	void *	addr,
		INT32U	nblks,
		INT32U	blksize,
		INT8U *	perr
	)

在文件 os_mem.c 第 59 行定义.

参考 OS_ENTER_CRITICAL, OS_ERR_MEM_INVALID_ADDR, OS_ERR_MEM_INVALID_BLKS, OS_ERR_MEM_INVALID_PART, OS_ERR_MEM_INVALID_SIZE, OS_ERR_NONE, OS_EXIT_CRITICAL, OS_MEM::OSMemAddr, OS_MEM::OSMemBlkSize, OS_MEM::OSMemFreeList, OSMemFreeList, OS_MEM::OSMemNBlks , 以及 OS_MEM::OSMemNFree.

{
    OS_MEM    *pmem;
    INT8U     *pblk;
    void     **plink;
    INT32U     i;
#if OS_CRITICAL_METHOD == 3u                          /* Allocate storage for CPU status register      */
    OS_CPU_SR  cpu_sr = 0u;
#endif



#if OS_ARG_CHK_EN > 0u
    if (perr == (INT8U *)0) {                         /* Validate 'perr'                               */
        return ((OS_MEM *)0);
    }
    if (addr == (void *)0) {                          /* Must pass a valid address for the memory part.*/
        *perr = OS_ERR_MEM_INVALID_ADDR;
        return ((OS_MEM *)0);
    }
    if (((INT32U)addr & (sizeof(void *) - 1u)) != 0u){  /* Must be pointer size aligned                */
        *perr = OS_ERR_MEM_INVALID_ADDR;
        return ((OS_MEM *)0);
    }
    if (nblks < 2u) {                                 /* Must have at least 2 blocks per partition     */
        *perr = OS_ERR_MEM_INVALID_BLKS;
        return ((OS_MEM *)0);
    }
    if (blksize < sizeof(void *)) {                   /* Must contain space for at least a pointer     */
        *perr = OS_ERR_MEM_INVALID_SIZE;
        return ((OS_MEM *)0);
    }
#endif
    OS_ENTER_CRITICAL();
    pmem = OSMemFreeList;                             /* Get next free memory partition                */
    if (OSMemFreeList != (OS_MEM *)0) {               /* See if pool of free partitions was empty      */
        OSMemFreeList = (OS_MEM *)OSMemFreeList->OSMemFreeList;
    }
    OS_EXIT_CRITICAL();
    if (pmem == (OS_MEM *)0) {                        /* See if we have a memory partition             */
        *perr = OS_ERR_MEM_INVALID_PART;
        return ((OS_MEM *)0);
    }
    plink = (void **)addr;                            /* Create linked list of free memory blocks      */
    pblk  = (INT8U *)((INT32U)addr + blksize);
    for (i = 0u; i < (nblks - 1u); i++) {
       *plink = (void *)pblk;                         /* Save pointer to NEXT block in CURRENT block   */
        plink = (void **)pblk;                        /* Position to  NEXT      block                  */
        pblk  = (INT8U *)((INT32U)pblk + blksize);    /* Point to the FOLLOWING block                  */
    }
    *plink              = (void *)0;                  /* Last memory block points to NULL              */
    pmem->OSMemAddr     = addr;                       /* Store start address of memory partition       */
    pmem->OSMemFreeList = addr;                       /* Initialize pointer to pool of free blocks     */
    pmem->OSMemNFree    = nblks;                      /* Store number of free blocks in MCB            */
    pmem->OSMemNBlks    = nblks;
    pmem->OSMemBlkSize  = blksize;                    /* Store block size of each memory blocks        */
    *perr               = OS_ERR_NONE;
    return (pmem);
}

void* OSMemGet	(	OS_MEM *	pmem,
		INT8U *	perr
	)

在文件 os_mem.c 第 142 行定义.

参考 OS_ENTER_CRITICAL, OS_ERR_MEM_INVALID_PMEM, OS_ERR_MEM_NO_FREE_BLKS, OS_ERR_NONE, OS_EXIT_CRITICAL, OS_MEM::OSMemFreeList , 以及 OS_MEM::OSMemNFree.

{
    void      *pblk;
#if OS_CRITICAL_METHOD == 3u                          /* Allocate storage for CPU status register      */
    OS_CPU_SR  cpu_sr = 0u;
#endif



#if OS_ARG_CHK_EN > 0u
    if (perr == (INT8U *)0) {                         /* Validate 'perr'                               */
        return ((void *)0);
    }
    if (pmem == (OS_MEM *)0) {                        /* Must point to a valid memory partition        */
        *perr = OS_ERR_MEM_INVALID_PMEM;
        return ((void *)0);
    }
#endif
    OS_ENTER_CRITICAL();
    if (pmem->OSMemNFree > 0u) {                      /* See if there are any free memory blocks       */
        pblk                = pmem->OSMemFreeList;    /* Yes, point to next free memory block          */
        pmem->OSMemFreeList = *(void **)pblk;         /*      Adjust pointer to new free list          */
        pmem->OSMemNFree--;                           /*      One less memory block in this partition  */
        OS_EXIT_CRITICAL();
        *perr = OS_ERR_NONE;                          /*      No error                                 */
        return (pblk);                                /*      Return memory block to caller            */
    }
    OS_EXIT_CRITICAL();
    *perr = OS_ERR_MEM_NO_FREE_BLKS;                  /* No,  Notify caller of empty memory partition  */
    return ((void *)0);                               /*      Return NULL pointer to caller            */
}

INT8U OSMemNameGet	(	OS_MEM *	pmem,
		INT8U **	pname,
		INT8U *	perr
	)

在文件 os_mem.c 第 197 行定义.

参考 OS_ENTER_CRITICAL, OS_ERR_MEM_INVALID_PMEM, OS_ERR_NAME_GET_ISR, OS_ERR_NONE, OS_ERR_PNAME_NULL, OS_EXIT_CRITICAL, OS_StrLen(), OSIntNesting , 以及 OS_MEM::OSMemName.

{
    INT8U      len;
#if OS_CRITICAL_METHOD == 3u                     /* Allocate storage for CPU status register           */
    OS_CPU_SR  cpu_sr = 0u;
#endif



#if OS_ARG_CHK_EN > 0u
    if (perr == (INT8U *)0) {                    /* Validate 'perr'                                    */
        return (0u);
    }
    if (pmem == (OS_MEM *)0) {                   /* Is 'pmem' a NULL pointer?                          */
        *perr = OS_ERR_MEM_INVALID_PMEM;
        return (0u);
    }
    if (pname == (INT8U **)0) {                  /* Is 'pname' a NULL pointer?                         */
        *perr = OS_ERR_PNAME_NULL;
        return (0u);
    }
#endif
    if (OSIntNesting > 0u) {                     /* See if trying to call from an ISR                  */
        *perr = OS_ERR_NAME_GET_ISR;
        return (0u);
    }
    OS_ENTER_CRITICAL();
    *pname = pmem->OSMemName;
    len    = OS_StrLen(*pname);
    OS_EXIT_CRITICAL();
    *perr  = OS_ERR_NONE;
    return (len);
}

函数调用图:

void OSMemNameSet	(	OS_MEM *	pmem,
		INT8U *	pname,
		INT8U *	perr
	)

在文件 os_mem.c 第 258 行定义.

参考 OS_ENTER_CRITICAL, OS_ERR_MEM_INVALID_PMEM, OS_ERR_NAME_SET_ISR, OS_ERR_NONE, OS_ERR_PNAME_NULL, OS_EXIT_CRITICAL, OSIntNesting , 以及 OS_MEM::OSMemName.

{
#if OS_CRITICAL_METHOD == 3u                     /* Allocate storage for CPU status register           */
    OS_CPU_SR  cpu_sr = 0u;
#endif



#if OS_ARG_CHK_EN > 0u
    if (perr == (INT8U *)0) {                    /* Validate 'perr'                                    */
        return;
    }
    if (pmem == (OS_MEM *)0) {                   /* Is 'pmem' a NULL pointer?                          */
        *perr = OS_ERR_MEM_INVALID_PMEM;
        return;
    }
    if (pname == (INT8U *)0) {                   /* Is 'pname' a NULL pointer?                         */
        *perr = OS_ERR_PNAME_NULL;
        return;
    }
#endif
    if (OSIntNesting > 0u) {                     /* See if trying to call from an ISR                  */
        *perr = OS_ERR_NAME_SET_ISR;
        return;
    }
    OS_ENTER_CRITICAL();
    pmem->OSMemName = pname;
    OS_EXIT_CRITICAL();
    *perr           = OS_ERR_NONE;
}

INT8U OSMemPut	(	OS_MEM *	pmem,
		void *	pblk
	)

在文件 os_mem.c 第 311 行定义.

参考 OS_ENTER_CRITICAL, OS_ERR_MEM_FULL, OS_ERR_MEM_INVALID_PBLK, OS_ERR_MEM_INVALID_PMEM, OS_ERR_NONE, OS_EXIT_CRITICAL, OS_MEM::OSMemFreeList, OS_MEM::OSMemNBlks , 以及 OS_MEM::OSMemNFree.

{
#if OS_CRITICAL_METHOD == 3u                     /* Allocate storage for CPU status register           */
    OS_CPU_SR  cpu_sr = 0u;
#endif



#if OS_ARG_CHK_EN > 0u
    if (pmem == (OS_MEM *)0) {                   /* Must point to a valid memory partition             */
        return (OS_ERR_MEM_INVALID_PMEM);
    }
    if (pblk == (void *)0) {                     /* Must release a valid block                         */
        return (OS_ERR_MEM_INVALID_PBLK);
    }
#endif
    OS_ENTER_CRITICAL();
    if (pmem->OSMemNFree >= pmem->OSMemNBlks) {  /* Make sure all blocks not already returned          */
        OS_EXIT_CRITICAL();
        return (OS_ERR_MEM_FULL);
    }
    *(void **)pblk      = pmem->OSMemFreeList;   /* Insert released block into free block list         */
    pmem->OSMemFreeList = pblk;
    pmem->OSMemNFree++;                          /* One more memory block in this partition            */
    OS_EXIT_CRITICAL();
    return (OS_ERR_NONE);                        /* Notify caller that memory block was released       */
}

INT8U OSMemQuery	(	OS_MEM *	pmem,
		OS_MEM_DATA *	p_mem_data
	)

在文件 os_mem.c 第 359 行定义.

参考 OS_ENTER_CRITICAL, OS_ERR_MEM_INVALID_PDATA, OS_ERR_MEM_INVALID_PMEM, OS_ERR_NONE, OS_EXIT_CRITICAL, OS_MEM_DATA::OSAddr, OS_MEM_DATA::OSBlkSize, OS_MEM_DATA::OSFreeList, OS_MEM::OSMemAddr, OS_MEM::OSMemBlkSize, OS_MEM::OSMemFreeList, OS_MEM::OSMemNBlks, OS_MEM::OSMemNFree, OS_MEM_DATA::OSNBlks, OS_MEM_DATA::OSNFree , 以及 OS_MEM_DATA::OSNUsed.

{
#if OS_CRITICAL_METHOD == 3u                     /* Allocate storage for CPU status register           */
    OS_CPU_SR  cpu_sr = 0u;
#endif



#if OS_ARG_CHK_EN > 0u
    if (pmem == (OS_MEM *)0) {                   /* Must point to a valid memory partition             */
        return (OS_ERR_MEM_INVALID_PMEM);
    }
    if (p_mem_data == (OS_MEM_DATA *)0) {        /* Must release a valid storage area for the data     */
        return (OS_ERR_MEM_INVALID_PDATA);
    }
#endif
    OS_ENTER_CRITICAL();
    p_mem_data->OSAddr     = pmem->OSMemAddr;
    p_mem_data->OSFreeList = pmem->OSMemFreeList;
    p_mem_data->OSBlkSize  = pmem->OSMemBlkSize;
    p_mem_data->OSNBlks    = pmem->OSMemNBlks;
    p_mem_data->OSNFree    = pmem->OSMemNFree;
    OS_EXIT_CRITICAL();
    p_mem_data->OSNUsed    = p_mem_data->OSNBlks - p_mem_data->OSNFree;
    return (OS_ERR_NONE);
}

void OS_MemInit

(

void

)

在文件 os_mem.c 第 403 行定义.

参考 OS_MAX_MEM_PART, OS_MemClr(), OS_MEM::OSMemFreeList, OSMemFreeList, OS_MEM::OSMemName , 以及 OSMemTbl.

参考自 OSInit().

{
#if OS_MAX_MEM_PART == 1u
    OS_MemClr((INT8U *)&OSMemTbl[0], sizeof(OSMemTbl));   /* Clear the memory partition table          */
    OSMemFreeList               = (OS_MEM *)&OSMemTbl[0]; /* Point to beginning of free list           */
#if OS_MEM_NAME_EN > 0u
    OSMemFreeList->OSMemName    = (INT8U *)"?";           /* Unknown name                              */
#endif
#endif

#if OS_MAX_MEM_PART >= 2u
    OS_MEM  *pmem;
    INT16U   i;


    OS_MemClr((INT8U *)&OSMemTbl[0], sizeof(OSMemTbl));   /* Clear the memory partition table          */
    pmem = &OSMemTbl[0];                                  /* Point to memory control block (MCB)       */
    for (i = 0u; i < (OS_MAX_MEM_PART - 1u); i++) {       /* Init. list of free memory partitions      */
        pmem->OSMemFreeList = (void *)&OSMemTbl[i+1];     /* Chain list of free partitions             */
#if OS_MEM_NAME_EN > 0u
        pmem->OSMemName  = (INT8U *)"?";
#endif
        pmem++;
    }
    pmem->OSMemFreeList = (void *)0;                      /* Initialize last node                      */
#if OS_MEM_NAME_EN > 0u
    pmem->OSMemName = (INT8U *)"?";
#endif

    OSMemFreeList   = &OSMemTbl[0];                       /* Point to beginning of free list           */
#endif
}

函数调用图:

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