lib_mem.c

MCB2300_ucgui_LCD320240.rar LPC2368的uc/gui的移植

/*
*********************************************************************************************************
*   											uC/LIB
*   									CUSTOM LIBRARY MODULES
*
*   					   (c) Copyright 2004-2007; Micrium, Inc.; Weston, FL
*
*   			All rights reserved.  Protected by international copyright laws.
*
*   			uC/LIB is provided in source form for FREE evaluation, for educational
*   			use or peaceful research.  If you plan on using uC/LIB in a commercial
*   			product you need to contact Micrium to properly license its use in your
*   			product.  We provide ALL the source code for your convenience and to
*   			help you experience uC/LIB.  The fact that the source code is provided
*   			does NOT mean that you can use it without paying a licensing fee.
*
*   			Knowledge of the source code may NOT be used to develop a similar product.
*
*   			Please help us continue to provide the Embedded community with the finest
*   			software available.  Your honesty is greatly appreciated.
*********************************************************************************************************
*/

/*
*********************************************************************************************************
*
*   								  STANDARD MEMORY OPERATIONS
*
* Filename  	: lib_mem.c
* Version   	: V1.24
* Programmer(s) : ITJ
*********************************************************************************************************
* Note(s)   	: (1) NO compiler-supplied standard library functions are used in library or product software.
*
*   				  (a) ALL standard library functions are implemented in the custom library modules :
*
*   					  (1) \<Custom Library Directory>\lib*.*
*
*   					  (2) \<Custom Library Directory>\Ports\<cpu>\<compiler>\lib*_a.*
*
*   							where
*   									<Custom Library Directory>  	directory path for custom library software
*   									<cpu>   						directory name for specific processor (CPU)
*   									<compiler>  					directory name for specific compiler
*
*   				  (b) Product-specific library functions are implemented in individual products.
*********************************************************************************************************
*/


/*
*********************************************************************************************************
*   										 INCLUDE FILES
*********************************************************************************************************
*/

#define    LIB_MEM_MODULE
#include  <lib_mem.h>


/*$PAGE*/
/*
*********************************************************************************************************
*   										 LOCAL DEFINES
*********************************************************************************************************
*/


/*
*********************************************************************************************************
*   										LOCAL CONSTANTS
*********************************************************************************************************
*/


/*
*********************************************************************************************************
*   									   LOCAL DATA TYPES
*********************************************************************************************************
*/


/*
*********************************************************************************************************
*   										 LOCAL TABLES
*********************************************************************************************************
*/


/*
*********************************************************************************************************
*   									LOCAL GLOBAL VARIABLES
*********************************************************************************************************
*/


/*
*********************************************************************************************************
*   								   LOCAL FUNCTION PROTOTYPES
*********************************************************************************************************
*/


/*
*********************************************************************************************************
*   								  LOCAL CONFIGURATION ERRORS
*********************************************************************************************************
*/


/*$PAGE*/
/*
*********************************************************************************************************
*   										   Mem_Clr()
*
* Description : Clear data buffer (see Note #2).
*
* Argument(s) : pmem		Pointer to memory buffer to clear.
*
*   			size		Number of data buffer octets to clear.
*
* Return(s)   : none.
*
* Caller(s)   : various.
*
* Note(s)     : (1) Null clears allowed (i.e. 0-octet size).
*
*   				See also 'Mem_Set()  Note #1'.
*
*   			(2) Clear data by setting each data octet to 0.
*********************************************************************************************************
*/

void Mem_Clr(void *pmem, CPU_SIZE_T   size)
{
	Mem_Set((void *) pmem, (CPU_INT08U) 0, /* See Note #2.										 */
			(CPU_SIZE_T) size);
}


/*$PAGE*/
/*
*********************************************************************************************************
*   										   Mem_Set()
*
* Description : Fill data buffer with specified data octet.
*
* Argument(s) : pmem		Pointer to memory buffer to fill with specified data octet.
*
*   			data_val	Data fill octet value.
*
*   			size		Number of data buffer octets to fill.
*
* Return(s)   : none.
*
* Caller(s)   : various.
*
* Note(s)     : (1) Null sets allowed (i.e. 0-octet size).
*
*   			(2) For best CPU performance, optimized to fill data buffer using 'CPU_ALIGN'-sized data words.
*
*   				(a) Since many word-aligned processors REQUIRE that multi-octet words be accessed on 
*   					word-aligned addresses, 'CPU_ALIGN'd words MUST be accessed on 'CPU_ALIGN'd addresses.
*
*   			(3) Modulo arithmetic is used to determine whether a memory buffer starts on a 'CPU_ALIGN'
*   				address boundary.
*
*   				Modulo arithmetic in ANSI-C REQUIREs operations performed on integer values.  Thus, 
*   				address values MUST be cast to an appropriately-sized integer value PRIOR to any
*   				mem_align_modulo arithmetic operation.
*********************************************************************************************************
*/

void Mem_Set(void *pmem, CPU_INT08U   data_val, CPU_SIZE_T   size)
{
	CPU_SIZE_T   size_rem;
	CPU_ALIGN    data_align;
	CPU_ALIGN   *pmem_align;
	CPU_INT08U  *pmem_08;
	CPU_INT08U   mem_align_modulo;
	CPU_INT08U   i;


	if (size < 1)
	{
		/* See Note #1. 										*/
		return;
	}
	if (pmem == (void *) 0)
	{
		return;
	}


	data_align = 0;
	for (i = 0; i < sizeof(CPU_ALIGN); i++)
	{
		/* Fill each data_align octet with data val.			*/
		data_align <<= DEF_OCTET_NBR_BITS;
		data_align |= (CPU_ALIGN) data_val;
	}

	size_rem = (CPU_SIZE_T) size;
	mem_align_modulo = (CPU_INT08U) ((CPU_ADDR) pmem % sizeof(CPU_ALIGN));    /* See Note #3.   						  */

	pmem_08 = (CPU_INT08U *) pmem;
	if (mem_align_modulo != 0)
	{
		/* If leading octets avail, 				  ...   	*/
		i = mem_align_modulo;
		while ((size_rem > 0) &&								 /* ... start mem buf fill with leading octets ...  	 */
			   (i < sizeof(CPU_ALIGN)))
		{
			/* ... until next CPU_ALIGN word boundary.  			*/
			*pmem_08++ = data_val;
			size_rem -= sizeof(CPU_INT08U);
			i++;
		}
	}

	pmem_align = (CPU_ALIGN *) pmem_08; 						 /* See Note #2a.   									 */
	while (size_rem >= sizeof(CPU_ALIGN))
	{
		/* While mem buf aligned on CPU_ALIGN word boundaries,  */
		*pmem_align++ = data_align; 							 /* ... fill mem buf with    CPU_ALIGN-sized data.  	 */
		size_rem -= sizeof(CPU_ALIGN);
	}

	pmem_08 = (CPU_INT08U *) pmem_align;
	while (size_rem > 0)
	{
		/* Finish mem buf fill with trailing octets.			*/
		*pmem_08++ = data_val;
		size_rem -= sizeof(CPU_INT08U);
	}
}


/*$PAGE*/
/*
*********************************************************************************************************
*   										  Mem_Copy()
*
* Description : Copy data octets from one buffer to another buffer.
*
* Argument(s) : pdest   	Pointer to destination memory buffer.
*
*   			psrc		Pointer to source      memory buffer.
*
*   			size		Number of data buffer octets to copy.
*
* Return(s)   : none.