C51 COMPILER V8.08   OS_MEM                                                                04/13/2009 13:31:22 PAGE 1   


C51 COMPILER V8.08, COMPILATION OF MODULE OS_MEM
OBJECT MODULE PLACED IN OS_MEM.OBJ
COMPILER INVOKED BY: D:\Keil\C51\BIN\C51.EXE OS_MEM.C BROWSE DEBUG OBJECTEXTEND

line level    source

   1          /*
   2          *********************************************************************************************************
   3          *                                                uC/OS-II
   4          *                                          The Real-Time Kernel
   5          *                                            MEMORY MANAGEMENT
   6          *
   7          *                        (c) Copyright 1992-1998, Jean J. Labrosse, Plantation, FL
   8          *                                           All Rights Reserved
   9          *
  10          *                                                  V2.00
  11          *
  12          * File : OS_MEM.C
  13          * By   : Jean J. Labrosse
  14          *********************************************************************************************************
  15          */
  16          #define OS_MEM_GLOBALS
  17          //#ifndef  OS_MASTER_FILE
  18          #include "includes.h"
  19          //#endif
  20          
  21          #if OS_MEM_EN && OS_MAX_MEM_PART >= 2
              /*
              *********************************************************************************************************
              *                                         LOCAL GLOBAL VARIABLES
              *********************************************************************************************************
              */
              
              static  OS_MEM      *OSMemFreeList;            /* Pointer to free list of memory partitions            */
              static  OS_MEM       OSMemTbl[OS_MAX_MEM_PART];/* Storage for memory partition manager                 */
              /*$PAGE*/
              /*
              *********************************************************************************************************
              *                                        CREATE A MEMORY PARTITION
              *
              * Description : Create a fixed-sized memory partition that will be managed by uC/OS-II.
              *
              * Arguments   : addr     is the starting address of the memory partition
              *
              *               nblks    is the number of memory blocks to create from the partition.
              *
              *               blksize  is the size (in bytes) of each block in the memory partition.
              *
              *               err      is a pointer to a variable containing an error message which will be set by
              *                        this function to either:
              *             
              *                        OS_NO_ERR            if the memory partition has been created correctly.
              *                        OS_MEM_INVALID_PART  no free partitions available
              *                        OS_MEM_INVALID_BLKS  user specified an invalid number of blocks (must be >= 2)
              *                        OS_MEM_INVALID_SIZE  user specified an invalid block size 
              *                                             (must be greater than the size of a pointer)
              * Returns    : != (OS_MEM *)0  is the partition was created 
              *              == (OS_MEM *)0  if the partition was not created because of invalid arguments or, no
              *                              free partition is available.
              *********************************************************************************************************
              */
C51 COMPILER V8.08   OS_MEM                                                                04/13/2009 13:31:22 PAGE 2   

              
              OS_MEM *OSMemCreate (void *addr, INT32U nblks, INT32U blksize, INT8U *err)reentrant
              {
                  #if OS_CRITICAL_METHOD == 2
                      unsigned DTYPE int_ss;
                      #endif 
              
                      OS_MEM  *pmem;
                  INT8U   *pblk;
                  void   **plink;
                  INT32U   i;
              
              
                  if (nblks < 2) {                                  /* Must have at least 2 blocks per partition      */
                      *err = OS_MEM_INVALID_BLKS;
                      return ((OS_MEM *)0);
                  }
                  if (blksize < sizeof(void *)) {                   /* Must contain space for at least a pointer      */
                      *err = OS_MEM_INVALID_SIZE;
                      return ((OS_MEM *)0);
                  }
                  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             */
                      *err = OS_MEM_INVALID_PART;
                      return ((OS_MEM *)0);
                  }
                  plink = (void **)addr;                            /* Create linked list of free memory blocks      */
                  pblk  = (INT8U *)addr + blksize;
                  for (i = 0; i < (nblks - 1); i++) {
                      *plink = (void *)pblk;
                      plink  = (void **)pblk;
                      pblk   = pblk + blksize;
                  }
                  *plink = (void *)0;                               /* Last memory block points to NULL              */
                  OS_ENTER_CRITICAL();
                  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        */
                  OS_EXIT_CRITICAL();
                  *err   = OS_NO_ERR;
                  return (pmem);
              }
              /*$PAGE*/
              /*
              *********************************************************************************************************
              *                                          GET A MEMORY BLOCK
              *
              * Description : Get a memory block from a partition
              *
              * Arguments   : pmem    is a pointer to the memory partition control block
              *
              *               err     is a pointer to a variable containing an error message which will be set by this
              *                       function to either:
              *
              *                       OS_NO_ERR           if the memory partition has been created correctly.
C51 COMPILER V8.08   OS_MEM                                                                04/13/2009 13:31:22 PAGE 3   

              *                       OS_MEM_NO_FREE_BLKS if there are no more free memory blocks to allocate to caller
              *
              * Returns     : A pointer to a memory block if no error is detected
              *               A pointer to NULL if an error is detected
              *********************************************************************************************************
              */
              
              void *OSMemGet (OS_MEM *pmem, INT8U *err)reentrant
              {
                  #if OS_CRITICAL_METHOD == 2