]> git.sur5r.net Git - freertos/blob - FreeRTOS/Source/portable/GCC/ARM7_AT91FR40008/port.c
Update to MIT licensed FreeRTOS V10.0.0 - see https://www.freertos.org/History.txt
[freertos] / FreeRTOS / Source / portable / GCC / ARM7_AT91FR40008 / port.c
1 /*\r
2  * FreeRTOS Kernel V10.0.0\r
3  * Copyright (C) 2017 Amazon.com, Inc. or its affiliates.  All Rights Reserved.\r
4  *\r
5  * Permission is hereby granted, free of charge, to any person obtaining a copy of\r
6  * this software and associated documentation files (the "Software"), to deal in\r
7  * the Software without restriction, including without limitation the rights to\r
8  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\r
9  * the Software, and to permit persons to whom the Software is furnished to do so,\r
10  * subject to the following conditions:\r
11  *\r
12  * The above copyright notice and this permission notice shall be included in all\r
13  * copies or substantial portions of the Software. If you wish to use our Amazon\r
14  * FreeRTOS name, please do so in a fair use way that does not cause confusion.\r
15  *\r
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\r
18  * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\r
19  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\r
20  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\r
21  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
22  *\r
23  * http://www.FreeRTOS.org\r
24  * http://aws.amazon.com/freertos\r
25  *\r
26  * 1 tab == 4 spaces!\r
27  */\r
28 \r
29 \r
30 /*-----------------------------------------------------------\r
31  * Implementation of functions defined in portable.h for the Atmel AT91R40008\r
32  * port.\r
33  *\r
34  * Components that can be compiled to either ARM or THUMB mode are\r
35  * contained in this file.  The ISR routines, which can only be compiled\r
36  * to ARM mode are contained in portISR.c.\r
37  *----------------------------------------------------------*/\r
38 \r
39 /* Standard includes. */\r
40 #include <stdlib.h>\r
41 \r
42 /* Scheduler includes. */\r
43 #include "FreeRTOS.h"\r
44 #include "task.h"\r
45 \r
46 /* Hardware specific definitions. */\r
47 #include "AT91R40008.h"\r
48 #include "pio.h"\r
49 #include "aic.h"\r
50 #include "tc.h"\r
51 \r
52 /* Constants required to setup the task context. */\r
53 #define portINITIAL_SPSR                                ( ( StackType_t ) 0x1f ) /* System mode, ARM mode, interrupts enabled. */\r
54 #define portTHUMB_MODE_BIT                              ( ( StackType_t ) 0x20 )\r
55 #define portINSTRUCTION_SIZE                    ( ( StackType_t ) 4 )\r
56 #define portNO_CRITICAL_SECTION_NESTING ( ( StackType_t ) 0 )\r
57 #define portTICK_PRIORITY_6                             ( 6 )\r
58 /*-----------------------------------------------------------*/\r
59 \r
60 /* Setup the timer to generate the tick interrupts. */\r
61 static void prvSetupTimerInterrupt( void );\r
62 \r
63 /* \r
64  * The scheduler can only be started from ARM mode, so \r
65  * vPortISRStartFirstSTask() is defined in portISR.c. \r
66  */\r
67 extern void vPortISRStartFirstTask( void );\r
68 \r
69 /*-----------------------------------------------------------*/\r
70 \r
71 /* \r
72  * Initialise the stack of a task to look exactly as if a call to \r
73  * portSAVE_CONTEXT had been called.\r
74  *\r
75  * See header file for description. \r
76  */\r
77 StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters )\r
78 {\r
79 StackType_t *pxOriginalTOS;\r
80 \r
81         pxOriginalTOS = pxTopOfStack;\r
82         \r
83         /* To ensure asserts in tasks.c don't fail, although in this case the assert\r
84         is not really required. */\r
85         pxTopOfStack--;\r
86 \r
87         /* Setup the initial stack of the task.  The stack is set exactly as \r
88         expected by the portRESTORE_CONTEXT() macro. */\r
89 \r
90         /* First on the stack is the return address - which in this case is the\r
91         start of the task.  The offset is added to make the return address appear\r
92         as it would within an IRQ ISR. */\r
93         *pxTopOfStack = ( StackType_t ) pxCode + portINSTRUCTION_SIZE;          \r
94         pxTopOfStack--;\r
95 \r
96         *pxTopOfStack = ( StackType_t ) 0xaaaaaaaa;     /* R14 */\r
97         pxTopOfStack--; \r
98         *pxTopOfStack = ( StackType_t ) pxOriginalTOS; /* Stack used when task starts goes in R13. */\r
99         pxTopOfStack--;\r
100         *pxTopOfStack = ( StackType_t ) 0x12121212;     /* R12 */\r
101         pxTopOfStack--; \r
102         *pxTopOfStack = ( StackType_t ) 0x11111111;     /* R11 */\r
103         pxTopOfStack--; \r
104         *pxTopOfStack = ( StackType_t ) 0x10101010;     /* R10 */\r
105         pxTopOfStack--; \r
106         *pxTopOfStack = ( StackType_t ) 0x09090909;     /* R9 */\r
107         pxTopOfStack--; \r
108         *pxTopOfStack = ( StackType_t ) 0x08080808;     /* R8 */\r
109         pxTopOfStack--; \r
110         *pxTopOfStack = ( StackType_t ) 0x07070707;     /* R7 */\r
111         pxTopOfStack--; \r
112         *pxTopOfStack = ( StackType_t ) 0x06060606;     /* R6 */\r
113         pxTopOfStack--; \r
114         *pxTopOfStack = ( StackType_t ) 0x05050505;     /* R5 */\r
115         pxTopOfStack--; \r
116         *pxTopOfStack = ( StackType_t ) 0x04040404;     /* R4 */\r
117         pxTopOfStack--; \r
118         *pxTopOfStack = ( StackType_t ) 0x03030303;     /* R3 */\r
119         pxTopOfStack--; \r
120         *pxTopOfStack = ( StackType_t ) 0x02020202;     /* R2 */\r
121         pxTopOfStack--; \r
122         *pxTopOfStack = ( StackType_t ) 0x01010101;     /* R1 */\r
123         pxTopOfStack--; \r
124 \r
125         /* When the task starts is will expect to find the function parameter in\r
126         R0. */\r
127         *pxTopOfStack = ( StackType_t ) pvParameters; /* R0 */\r
128         pxTopOfStack--;\r
129 \r
130         /* The last thing onto the stack is the status register, which is set for\r
131         system mode, with interrupts enabled. */\r
132         *pxTopOfStack = ( StackType_t ) portINITIAL_SPSR;\r
133 \r
134         #ifdef THUMB_INTERWORK\r
135         {\r
136                 /* We want the task to start in thumb mode. */\r
137                 *pxTopOfStack |= portTHUMB_MODE_BIT;\r
138         }\r
139         #endif\r
140 \r
141         pxTopOfStack--;\r
142 \r
143         /* Some optimisation levels use the stack differently to others.  This \r
144         means the interrupt flags cannot always be stored on the stack and will\r
145         instead be stored in a variable, which is then saved as part of the\r
146         tasks context. */\r
147         *pxTopOfStack = portNO_CRITICAL_SECTION_NESTING;\r
148 \r
149         return pxTopOfStack;\r
150 }\r
151 /*-----------------------------------------------------------*/\r
152 \r
153 BaseType_t xPortStartScheduler( void )\r
154 {\r
155         /* Start the timer that generates the tick ISR.  Interrupts are disabled\r
156         here already. */\r
157         prvSetupTimerInterrupt();\r
158 \r
159         /* Start the first task. */\r
160         vPortISRStartFirstTask();       \r
161 \r
162         /* Should not get here! */\r
163         return 0;\r
164 }\r
165 /*-----------------------------------------------------------*/\r
166 \r
167 void vPortEndScheduler( void )\r
168 {\r
169         /* It is unlikely that the ARM port will require this function as there\r
170         is nothing to return to.  */\r
171 }\r
172 /*-----------------------------------------------------------*/\r
173 \r
174 /*\r
175  * Setup the tick timer to generate the tick interrupts at the required frequency.\r
176  */\r
177 static void prvSetupTimerInterrupt( void )\r
178 {\r
179 volatile uint32_t ulDummy;\r
180 \r
181         /* Enable clock to the tick timer... */\r
182         AT91C_BASE_PS->PS_PCER = portTIMER_CLK_ENABLE_BIT;\r
183 \r
184         /* Stop the tick timer... */\r
185         portTIMER_REG_BASE_PTR->TC_CCR = TC_CLKDIS;\r
186 \r
187         /* Start with tick timer interrupts disabled... */\r
188         portTIMER_REG_BASE_PTR->TC_IDR = 0xFFFFFFFF;\r
189 \r
190         /* Clear any pending tick timer interrupts... */\r
191         ulDummy = portTIMER_REG_BASE_PTR->TC_SR;\r
192 \r
193         /* Store interrupt handler function address in tick timer vector register...\r
194         The ISR installed depends on whether the preemptive or cooperative\r
195         scheduler is being used. */\r
196         #if configUSE_PREEMPTION == 1\r
197         {\r
198                 extern void ( vPreemptiveTick )( void );\r
199                 AT91C_BASE_AIC->AIC_SVR[portTIMER_AIC_CHANNEL] = ( uint32_t ) vPreemptiveTick;\r
200         }\r
201         #else  // else use cooperative scheduler\r
202         {\r
203                 extern void ( vNonPreemptiveTick )( void );\r
204                 AT91C_BASE_AIC->AIC_SVR[portTIMER_AIC_CHANNEL] = ( uint32_t ) vNonPreemptiveTick;\r
205         }\r
206         #endif\r
207 \r
208         /* Tick timer interrupt level-sensitive, priority 6... */\r
209         AT91C_BASE_AIC->AIC_SMR[ portTIMER_AIC_CHANNEL ] = AIC_SRCTYPE_INT_LEVEL_SENSITIVE | portTICK_PRIORITY_6;\r
210 \r
211         /* Enable the tick timer interrupt...\r
212 \r
213         First at timer level */\r
214         portTIMER_REG_BASE_PTR->TC_IER = TC_CPCS;\r
215 \r
216         /* Then at the AIC level. */\r
217         AT91C_BASE_AIC->AIC_IECR = (1 << portTIMER_AIC_CHANNEL);\r
218 \r
219         /* Calculate timer compare value to achieve the desired tick rate... */\r
220         if( (configCPU_CLOCK_HZ / (configTICK_RATE_HZ * 2) ) <= 0xFFFF )\r
221         {\r
222                 /* The tick rate is fast enough for us to use the faster timer input\r
223                 clock (main clock / 2). */\r
224                 portTIMER_REG_BASE_PTR->TC_CMR = TC_WAVE | TC_CLKS_MCK2 | TC_BURST_NONE | TC_CPCTRG;\r
225                 portTIMER_REG_BASE_PTR->TC_RC  = configCPU_CLOCK_HZ / (configTICK_RATE_HZ * 2);\r
226         }\r
227         else\r
228         {\r
229                 /* We must use a slower timer input clock (main clock / 8) because the\r
230                 tick rate is too slow for the faster input clock. */\r
231                 portTIMER_REG_BASE_PTR->TC_CMR = TC_WAVE | TC_CLKS_MCK8 | TC_BURST_NONE | TC_CPCTRG;\r
232                 portTIMER_REG_BASE_PTR->TC_RC  = configCPU_CLOCK_HZ / (configTICK_RATE_HZ * 8);\r
233         }\r
234 \r
235         /* Start tick timer... */\r
236         portTIMER_REG_BASE_PTR->TC_CCR = TC_SWTRG | TC_CLKEN;\r
237 }\r
238 /*-----------------------------------------------------------*/\r
239 \r