2 FreeRTOS.org V5.1.2 - Copyright (C) 2003-2009 Richard Barry.
\r
4 This file is part of the FreeRTOS.org distribution.
\r
6 FreeRTOS.org is free software; you can redistribute it and/or modify
\r
7 it under the terms of the GNU General Public License as published by
\r
8 the Free Software Foundation; either version 2 of the License, or
\r
9 (at your option) any later version.
\r
11 FreeRTOS.org is distributed in the hope that it will be useful,
\r
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
\r
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\r
14 GNU General Public License for more details.
\r
16 You should have received a copy of the GNU General Public License
\r
17 along with FreeRTOS.org; if not, write to the Free Software
\r
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
\r
20 A special exception to the GPL can be applied should you wish to distribute
\r
21 a combined work that includes FreeRTOS.org, without being obliged to provide
\r
22 the source code for any proprietary components. See the licensing section
\r
23 of http://www.FreeRTOS.org for full details of how and when the exception
\r
26 ***************************************************************************
\r
27 ***************************************************************************
\r
29 * Get the FreeRTOS eBook! See http://www.FreeRTOS.org/Documentation *
\r
31 * This is a concise, step by step, 'hands on' guide that describes both *
\r
32 * general multitasking concepts and FreeRTOS specifics. It presents and *
\r
33 * explains numerous examples that are written using the FreeRTOS API. *
\r
34 * Full source code for all the examples is provided in an accompanying *
\r
37 ***************************************************************************
\r
38 ***************************************************************************
\r
40 Please ensure to read the configuration and relevant port sections of the
\r
41 online documentation.
\r
43 http://www.FreeRTOS.org - Documentation, latest information, license and
\r
46 http://www.SafeRTOS.com - A version that is certified for use in safety
\r
49 http://www.OpenRTOS.com - Commercial support, development, porting,
\r
50 licensing and training services.
\r
53 /*-----------------------------------------------------------
\r
54 * Implementation of functions defined in portable.h for the ARM CM3 port.
\r
55 *----------------------------------------------------------*/
\r
57 /* Scheduler includes. */
\r
58 #include "FreeRTOS.h"
\r
61 #ifndef configKERNEL_INTERRUPT_PRIORITY
\r
62 #define configKERNEL_INTERRUPT_PRIORITY 255
\r
65 /* Constants required to manipulate the NVIC. */
\r
66 #define portNVIC_SYSTICK_CTRL ( ( volatile unsigned portLONG *) 0xe000e010 )
\r
67 #define portNVIC_SYSTICK_LOAD ( ( volatile unsigned portLONG *) 0xe000e014 )
\r
68 #define portNVIC_INT_CTRL ( ( volatile unsigned portLONG *) 0xe000ed04 )
\r
69 #define portNVIC_SYSPRI2 ( ( volatile unsigned portLONG *) 0xe000ed20 )
\r
70 #define portNVIC_SYSTICK_CLK 0x00000004
\r
71 #define portNVIC_SYSTICK_INT 0x00000002
\r
72 #define portNVIC_SYSTICK_ENABLE 0x00000001
\r
73 #define portNVIC_PENDSVSET 0x10000000
\r
74 #define portNVIC_PENDSV_PRI ( ( ( unsigned portLONG ) configKERNEL_INTERRUPT_PRIORITY ) << 16 )
\r
75 #define portNVIC_SYSTICK_PRI ( ( ( unsigned portLONG ) configKERNEL_INTERRUPT_PRIORITY ) << 24 )
\r
77 /* Constants required to set up the initial stack. */
\r
78 #define portINITIAL_XPSR ( 0x01000000 )
\r
80 /* Each task maintains its own interrupt status in the critical nesting
\r
82 static unsigned portBASE_TYPE uxCriticalNesting = 0xaaaaaaaa;
\r
85 * Setup the timer to generate the tick interrupts.
\r
87 static void prvSetupTimerInterrupt( void );
\r
90 * Exception handlers.
\r
92 void xPortPendSVHandler( void );
\r
93 void xPortSysTickHandler( void );
\r
94 void vPortSVCHandler( void );
\r
97 * Start first task is a separate function so it can be tested in isolation.
\r
99 void vPortStartFirstTask( void );
\r
101 /*-----------------------------------------------------------*/
\r
104 * See header file for description.
\r
106 portSTACK_TYPE *pxPortInitialiseStack( portSTACK_TYPE *pxTopOfStack, pdTASK_CODE pxCode, void *pvParameters )
\r
108 /* Simulate the stack frame as it would be created by a context switch
\r
110 *pxTopOfStack = portINITIAL_XPSR; /* xPSR */
\r
112 *pxTopOfStack = ( portSTACK_TYPE ) pxCode; /* PC */
\r
114 *pxTopOfStack = 0; /* LR */
\r
115 pxTopOfStack -= 5; /* R12, R3, R2 and R1. */
\r
116 *pxTopOfStack = ( portSTACK_TYPE ) pvParameters; /* R0 */
\r
117 pxTopOfStack -= 8; /* R11, R10, R9, R8, R7, R6, R5 and R4. */
\r
119 return pxTopOfStack;
\r
121 /*-----------------------------------------------------------*/
\r
123 __asm void vPortSVCHandler( void )
\r
127 ldr r3, =pxCurrentTCB /* Restore the context. */
\r
128 ldr r1, [r3] /* Use pxCurrentTCBConst to get the pxCurrentTCB address. */
\r
129 ldr r0, [r1] /* The first item in pxCurrentTCB is the task top of stack. */
\r
130 ldmia r0!, {r4-r11} /* Pop the registers that are not automatically saved on exception entry and the critical nesting count. */
\r
131 msr psp, r0 /* Restore the task stack pointer. */
\r
137 /*-----------------------------------------------------------*/
\r
139 __asm void vPortStartFirstTask( void )
\r
143 /* Use the NVIC offset register to locate the stack. */
\r
144 ldr r0, =0xE000ED08
\r
147 /* Set the msp back to the start of the stack. */
\r
149 /* Call SVC to start the first task. */
\r
152 /*-----------------------------------------------------------*/
\r
155 * See header file for description.
\r
157 portBASE_TYPE xPortStartScheduler( void )
\r
159 /* Make PendSV, CallSV and SysTick the same priroity as the kernel. */
\r
160 *(portNVIC_SYSPRI2) |= portNVIC_PENDSV_PRI;
\r
161 *(portNVIC_SYSPRI2) |= portNVIC_SYSTICK_PRI;
\r
163 /* Start the timer that generates the tick ISR. Interrupts are disabled
\r
165 prvSetupTimerInterrupt();
\r
167 /* Initialise the critical nesting count ready for the first task. */
\r
168 uxCriticalNesting = 0;
\r
170 /* Start the first task. */
\r
171 vPortStartFirstTask();
\r
173 /* Should not get here! */
\r
176 /*-----------------------------------------------------------*/
\r
178 void vPortEndScheduler( void )
\r
180 /* It is unlikely that the CM3 port will require this function as there
\r
181 is nothing to return to. */
\r
183 /*-----------------------------------------------------------*/
\r
185 void vPortYieldFromISR( void )
\r
187 /* Set a PendSV to request a context switch. */
\r
188 *(portNVIC_INT_CTRL) = portNVIC_PENDSVSET;
\r
190 /*-----------------------------------------------------------*/
\r
192 void vPortEnterCritical( void )
\r
194 portDISABLE_INTERRUPTS();
\r
195 uxCriticalNesting++;
\r
197 /*-----------------------------------------------------------*/
\r
199 void vPortExitCritical( void )
\r
201 uxCriticalNesting--;
\r
202 if( uxCriticalNesting == 0 )
\r
204 portENABLE_INTERRUPTS();
\r
207 /*-----------------------------------------------------------*/
\r
209 __asm void xPortPendSVHandler( void )
\r
211 extern uxCriticalNesting;
\r
212 extern pxCurrentTCB;
\r
213 extern vTaskSwitchContext;
\r
219 ldr r3, =pxCurrentTCB /* Get the location of the current TCB. */
\r
222 stmdb r0!, {r4-r11} /* Save the remaining registers. */
\r
223 str r0, [r2] /* Save the new top of stack into the first member of the TCB. */
\r
225 stmdb sp!, {r3, r14}
\r
226 mov r0, #configMAX_SYSCALL_INTERRUPT_PRIORITY
\r
228 bl vTaskSwitchContext
\r
231 ldmia sp!, {r3, r14}
\r
234 ldr r0, [r1] /* The first item in pxCurrentTCB is the task top of stack. */
\r
235 ldmia r0!, {r4-r11} /* Pop the registers and the critical nesting count. */
\r
240 /*-----------------------------------------------------------*/
\r
242 void xPortSysTickHandler( void )
\r
244 unsigned portLONG ulDummy;
\r
246 /* If using preemption, also force a context switch. */
\r
247 #if configUSE_PREEMPTION == 1
\r
248 *(portNVIC_INT_CTRL) = portNVIC_PENDSVSET;
\r
251 ulDummy = portSET_INTERRUPT_MASK_FROM_ISR();
\r
253 vTaskIncrementTick();
\r
255 portCLEAR_INTERRUPT_MASK_FROM_ISR( ulDummy );
\r
257 /*-----------------------------------------------------------*/
\r
260 * Setup the systick timer to generate the tick interrupts at the required
\r
263 void prvSetupTimerInterrupt( void )
\r
265 /* Configure SysTick to interrupt at the requested rate. */
\r
266 *(portNVIC_SYSTICK_LOAD) = ( configCPU_CLOCK_HZ / configTICK_RATE_HZ ) - 1UL;
\r
267 *(portNVIC_SYSTICK_CTRL) = portNVIC_SYSTICK_CLK | portNVIC_SYSTICK_INT | portNVIC_SYSTICK_ENABLE;
\r
269 /*-----------------------------------------------------------*/
\r
271 __asm void vPortSetInterruptMask( void )
\r
276 mov r0, #configMAX_SYSCALL_INTERRUPT_PRIORITY
\r
282 /*-----------------------------------------------------------*/
\r
284 __asm void vPortClearInterruptMask( void )
\r