This repository has been archived on 2023-11-05. You can view files and clone it, but cannot push or open issues or pull requests.
FreeRTOS-Kernel/Source/portable/Keil/ARM7/portmacro.h
Richard Barry 946da76519
2006-05-28 08:17:56 +00:00

225 lines
9.3 KiB
C

/*
FreeRTOS.org V4.0.2 - Copyright (C) 2003-2006 Richard Barry.
This file is part of the FreeRTOS.org distribution.
FreeRTOS.org is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
FreeRTOS.org is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with FreeRTOS.org; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
A special exception to the GPL can be applied should you wish to distribute
a combined work that includes FreeRTOS.org, without being obliged to provide
the source code for any proprietary components. See the licensing section
of http://www.FreeRTOS.org for full details of how and when the exception
can be applied.
***************************************************************************
See http://www.FreeRTOS.org for documentation, latest information, license
and contact details. Please ensure to read the configuration and relevant
port sections of the online documentation.
***************************************************************************
*/
#ifndef PORTMACRO_H
#define PORTMACRO_H
/*-----------------------------------------------------------
* Port specific definitions.
*
* The settings in this file configure FreeRTOS correctly for the
* given hardware and compiler.
*
* These settings should not be altered.
*-----------------------------------------------------------
*/
/* Type definitions. */
#define portCHAR char
#define portFLOAT float
#define portDOUBLE double
#define portLONG long
#define portSHORT short
#define portSTACK_TYPE unsigned portLONG
#define portBASE_TYPE portLONG
#if( configUSE_16_BIT_TICKS == 1 )
typedef unsigned portSHORT portTickType;
#define portMAX_DELAY ( portTickType ) 0xffff
#else
typedef unsigned portLONG portTickType;
#define portMAX_DELAY ( portTickType ) 0xffffffff
#endif
/*-----------------------------------------------------------*/
/* Hardware specifics. */
#define portSTACK_GROWTH ( -1 )
#define portTICK_RATE_MS ( ( portTickType ) 1000 / configTICK_RATE_HZ )
#define portBYTE_ALIGNMENT 4
/*-----------------------------------------------------------*/
/* Task utilities. */
#define portRESTORE_CONTEXT() \
{ \
extern volatile unsigned portLONG ulCriticalNesting; \
extern volatile void * volatile pxCurrentTCB; \
\
__asm{ LDR R1, =pxCurrentTCB };/* Set the LR to the task stack. The location was ... */ \
__asm{ LDR R0, [R1] }; /* ... stored in pxCurrentTCB. */ \
__asm{ LDR LR, [R0] }; \
\
__asm{ LDR R0, =ulCriticalNesting }; /* The critical nesting depth is the first item on ... */ \
__asm{ LDMFD LR!, {R1 } } /* ... the stack. Load it into the ulCriticalNesting var. */ \
__asm{ STR R1, [R0] } \
\
__asm{ LDMFD LR!, {R0} }; /* Get the SPSR from the stack. */ \
__asm{ MSR SPSR_CXSF, R0 }; \
\
__asm{ LDMFD LR, {R0-R14}^ }; /* Restore all system mode registers for the task. */ \
__asm{ NOP }; \
\
__asm{ LDR LR, [LR, #+60] }; /* Restore the return address. */ \
\
/* And return - correcting the offset in the LR to obtain ... */ \
__asm{ SUBS PC, LR, #4 }; /* ... the correct address. */ \
}
/*----------------------------------------------------------*/
#define portSAVE_CONTEXT() \
{ \
extern volatile unsigned portLONG ulCriticalNesting; \
extern volatile void * volatile pxCurrentTCB; \
\
__asm{ STMDB SP!, {R0} }; /* Store R0 first as we need to use it. */ \
\
__asm{ STMDB SP,{SP}^ }; /* Set R0 to point to the task stack pointer. */ \
__asm{ NOP }; \
__asm{ SUB SP, SP, #4 }; \
__asm{ LDMIA SP!,{R0} }; \
\
__asm{ STMDB R0!, {LR} }; /* Push the return address onto the stack. */ \
__asm{ MOV LR, R0 }; /* Now we have saved LR we can use it instead of R0. */ \
__asm{ LDMIA SP!, {R0} }; /* Pop R0 so we can save it onto the system mode stack. */ \
\
__asm{ STMDB LR,{R0-LR}^ }; /* Push all the system mode registers onto the task stack. */ \
__asm{ NOP }; \
__asm{ SUB LR, LR, #60 }; \
\
__asm{ MRS R0, SPSR }; /* Push the SPSR onto the task stack. */ \
__asm{ STMDB LR!, {R0} }; \
\
__asm{ LDR R0, =ulCriticalNesting }; \
__asm{ LDR R0, [R0] }; \
__asm{ STMDB LR!, {R0} }; \
\
__asm{ LDR R0, =pxCurrentTCB };/* Store the new top of stack for the task. */ \
__asm{ LDR R1, [R0] }; \
__asm{ STR LR, [R1] }; \
}
/*-----------------------------------------------------------
* ISR entry and exit macros. These are only required if a task switch
* is required from an ISR.
*----------------------------------------------------------*/
#define portENTER_SWITCHING_ISR() \
portSAVE_CONTEXT(); \
{
#define portEXIT_SWITCHING_ISR( SwitchRequired ) \
/* If a switch is required then we just need to call */ \
/* vTaskSwitchContext() as the context has already been */ \
/* saved. */ \
if( SwitchRequired ) \
{ \
vTaskSwitchContext(); \
} \
} \
/* Restore the context of which ever task is now the highest */ \
/* priority that is ready to run. */ \
portRESTORE_CONTEXT();
/* Yield the processor - force a context switch. */
#define portYIELD() __asm{ SWI 0 };
/*-----------------------------------------------------------*/
/* Critical section management. */
/*-----------------------------------------------------------
* Interrupt control macros.
*
* The interrupt management utilities can only be called from ARM mode. When
* KEIL_THUMB_INTERWORK is defined the utilities are defined as functions in
* portISR.c to ensure a switch to ARM mode. When KEIL_THUMB_INTERWORK is not
* defined then the utilities are defined as macros here - as per other ports.
*----------------------------------------------------------*/
#ifdef KEIL_THUMB_INTERWORK
extern void vPortDisableInterruptsFromThumb( void ) __task;
extern void vPortEnableInterruptsFromThumb( void ) __task;
#define portDISABLE_INTERRUPTS() vPortDisableInterruptsFromThumb()
#define portENABLE_INTERRUPTS() vPortEnableInterruptsFromThumb()
#else
/*-----------------------------------------------------------*/
#define portDISABLE_INTERRUPTS() \
__asm{ STMDB SP!, {R0} }; /* Push R0. */ \
__asm{ MRS R0, CPSR }; /* Get CPSR. */ \
__asm{ ORR R0, R0, #0xC0 }; /* Disable IRQ, FIQ. */ \
__asm{ MSR CPSR_CXSF, R0 }; /* Write back modified value. */ \
__asm{ LDMIA SP!, {R0} } /* Pop R0. */
#define portENABLE_INTERRUPTS() \
__asm{ STMDB SP!, {R0} }; /* Push R0. */ \
__asm{ MRS R0, CPSR }; /* Get CPSR. */ \
__asm{ BIC R0, R0, #0xC0 }; /* Enable IRQ, FIQ. */ \
__asm{ MSR CPSR_CXSF, R0 }; /* Write back modified value. */ \
__asm{ LDMIA SP!, {R0} } /* Pop R0. */
#endif /* KEIL_THUMB_INTERWORK */
/*-----------------------------------------------------------
* Critical section control
*
* The code generated by the Keil compiler does not maintain separate
* stack and frame pointers. The portENTER_CRITICAL macro cannot therefore
* use the stack as per other ports. Instead a variable is used to keep
* track of the critical section nesting. This necessitates the use of a
* function in place of the macro.
*----------------------------------------------------------*/
extern void vPortEnterCritical( void );
extern void vPortExitCritical( void );
#define portENTER_CRITICAL() vPortEnterCritical();
#define portEXIT_CRITICAL() vPortExitCritical();
/*-----------------------------------------------------------*/
/* Compiler specifics. */
#define inline
#define register
#define portNOP() __asm{ NOP }
/*-----------------------------------------------------------*/
/* Task function macros as described on the FreeRTOS.org WEB site. */
#define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters ) __task
#define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )
#endif /* PORTMACRO_H */