1 /*
2 * FreeRTOS Kernel V11.1.0
3 * Copyright (C) 2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.
4 *
5 * SPDX-License-Identifier: MIT
6 *
7 * Permission is hereby granted, free of charge, to any person obtaining a copy of
8 * this software and associated documentation files (the "Software"), to deal in
9 * the Software without restriction, including without limitation the rights to
10 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
11 * the Software, and to permit persons to whom the Software is furnished to do so,
12 * subject to the following conditions:
13 *
14 * The above copyright notice and this permission notice shall be included in all
15 * copies or substantial portions of the Software.
16 *
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
19 * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
20 * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
21 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
22 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23 *
24 * https://www.FreeRTOS.org
25 * https://github.com/FreeRTOS
26 *
27 */
28
29 #include "FreeRTOS.h"
30 #include "task.h"
31 #include "mb91467d.h"
32
33 /*-----------------------------------------------------------*/
34
35 /* We require the address of the pxCurrentTCB variable, but don't want to know
36 any details of its type. */
37 typedef void TCB_t;
38 extern volatile TCB_t * volatile pxCurrentTCB;
39
40 /*-----------------------------------------------------------*/
41
42 #pragma asm
43 #macro SaveContext
44 ORCCR #0x20 ;Switch to user stack
45 ST RP,@-R15 ;Store RP
46 STM0 (R7,R6,R5,R4,R3,R2,R1,R0) ;Store R7-R0
47 STM1 (R14,R13,R12,R11,R10,R9,R8) ;Store R14-R8
48 ST MDH, @-R15 ;Store MDH
49 ST MDL, @-R15 ;Store MDL
50
51 ANDCCR #0xDF ;Switch back to system stack
52 LD @R15+,R0 ;Store PC to R0
53 ORCCR #0x20 ;Switch to user stack
54 ST R0,@-R15 ;Store PC to User stack
55
56 ANDCCR #0xDF ;Switch back to system stack
57 LD @R15+,R0 ;Store PS to R0
58 ORCCR #0x20 ;Switch to user stack
59 ST R0,@-R15 ;Store PS to User stack
60
61 LDI #_pxCurrentTCB, R0 ;Get pxCurrentTCB address
62 LD @R0, R0 ;Get the pxCurrentTCB->pxTopOfStack address
63 ST R15,@R0 ;Store USP to pxCurrentTCB->pxTopOfStack
64
65 ANDCCR #0xDF ;Switch back to system stack for the rest of tick ISR
66 #endm
67
68 #macro RestoreContext
69 LDI #_pxCurrentTCB, R0 ;Get pxCurrentTCB address
70 LD @R0, R0 ;Get the pxCurrentTCB->pxTopOfStack address
71 ORCCR #0x20 ;Switch to user stack
72 LD @R0, R15 ;Restore USP from pxCurrentTCB->pxTopOfStack
73
74 LD @R15+,R0 ;Store PS to R0
75 ANDCCR #0xDF ;Switch to system stack
76 ST R0,@-R15 ;Store PS to system stack
77
78 ORCCR #0x20 ;Switch to user stack
79 LD @R15+,R0 ;Store PC to R0
80 ANDCCR #0xDF ;Switch to system stack
81 ST R0,@-R15 ;Store PC to system stack
82
83 ORCCR #0x20 ;Switch back to retrieve the remaining context
84
85 LD @R15+, MDL ;Restore MDL
86 LD @R15+, MDH ;Restore MDH
87 LDM1 (R14,R13,R12,R11,R10,R9,R8) ;Restore R14-R8
88 LDM0 (R7,R6,R5,R4,R3,R2,R1,R0) ;Restore R7-R0
89 LD @R15+, RP ;Restore RP
90
91 ANDCCR #0xDF ;Switch back to system stack for the rest of tick ISR
92 #endm
93 #pragma endasm
94
95 /*-----------------------------------------------------------*/
96
97 /*
98 * Perform hardware setup to enable ticks from timer 1,
99 */
100 static void prvSetupTimerInterrupt( void );
101 /*-----------------------------------------------------------*/
102
103 /*
104 * Initialise the stack of a task to look exactly as if a call to
105 * portSAVE_CONTEXT had been called.
106 *
107 * See the header file portable.h.
108 */
pxPortInitialiseStack(StackType_t * pxTopOfStack,TaskFunction_t pxCode,void * pvParameters)109 StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters )
110 {
111 /* Place a few bytes of known values on the bottom of the stack.
112 This is just useful for debugging. */
113
114 *pxTopOfStack = 0x11111111;
115 pxTopOfStack--;
116 *pxTopOfStack = 0x22222222;
117 pxTopOfStack--;
118 *pxTopOfStack = 0x33333333;
119 pxTopOfStack--;
120
121 /* This is a redundant push to the stack, it may be required if
122 in some implementations of the compiler the parameter to the task
123 is passed on to the stack rather than in R4 register. */
124 *pxTopOfStack = (StackType_t)(pvParameters);
125 pxTopOfStack--;
126
127 *pxTopOfStack = ( StackType_t ) 0x00000000; /* RP */
128 pxTopOfStack--;
129 *pxTopOfStack = ( StackType_t ) 0x00007777; /* R7 */
130 pxTopOfStack--;
131 *pxTopOfStack = ( StackType_t ) 0x00006666; /* R6 */
132 pxTopOfStack--;
133 *pxTopOfStack = ( StackType_t ) 0x00005555; /* R5 */
134 pxTopOfStack--;
135
136 /* In the current implementation of the compiler the first
137 parameter to the task (or function) is passed via R4 parameter
138 to the task, hence the pvParameters pointer is copied into the R4
139 register. See compiler manual section 4.6.2 for more information. */
140 *pxTopOfStack = ( StackType_t ) (pvParameters); /* R4 */
141 pxTopOfStack--;
142 *pxTopOfStack = ( StackType_t ) 0x00003333; /* R3 */
143 pxTopOfStack--;
144 *pxTopOfStack = ( StackType_t ) 0x00002222; /* R2 */
145 pxTopOfStack--;
146 *pxTopOfStack = ( StackType_t ) 0x00001111; /* R1 */
147 pxTopOfStack--;
148 *pxTopOfStack = ( StackType_t ) 0x00000001; /* R0 */
149 pxTopOfStack--;
150 *pxTopOfStack = ( StackType_t ) 0x0000EEEE; /* R14 */
151 pxTopOfStack--;
152 *pxTopOfStack = ( StackType_t ) 0x0000DDDD; /* R13 */
153 pxTopOfStack--;
154 *pxTopOfStack = ( StackType_t ) 0x0000CCCC; /* R12 */
155 pxTopOfStack--;
156 *pxTopOfStack = ( StackType_t ) 0x0000BBBB; /* R11 */
157 pxTopOfStack--;
158 *pxTopOfStack = ( StackType_t ) 0x0000AAAA; /* R10 */
159 pxTopOfStack--;
160 *pxTopOfStack = ( StackType_t ) 0x00009999; /* R9 */
161 pxTopOfStack--;
162 *pxTopOfStack = ( StackType_t ) 0x00008888; /* R8 */
163 pxTopOfStack--;
164 *pxTopOfStack = ( StackType_t ) 0x11110000; /* MDH */
165 pxTopOfStack--;
166 *pxTopOfStack = ( StackType_t ) 0x22220000; /* MDL */
167 pxTopOfStack--;
168
169 /* The start of the task code. */
170 *pxTopOfStack = ( StackType_t ) pxCode; /* PC */
171 pxTopOfStack--;
172
173 /* PS - User Mode, USP, ILM=31, Interrupts enabled */
174 *pxTopOfStack = ( StackType_t ) 0x001F0030; /* PS */
175
176 return pxTopOfStack;
177 }
178 /*-----------------------------------------------------------*/
179
xPortStartScheduler(void)180 BaseType_t xPortStartScheduler( void )
181 {
182 /* Setup the hardware to generate the tick. */
183 prvSetupTimerInterrupt();
184
185 /* Restore the context of the first task that is going to run. */
186 #pragma asm
187 RestoreContext
188 #pragma endasm
189
190 /* Simulate a function call end as generated by the compiler. We will now
191 jump to the start of the task the context of which we have just restored. */
192 __asm(" reti ");
193
194 /* Should not get here. */
195 return pdFAIL;
196 }
197 /*-----------------------------------------------------------*/
198
vPortEndScheduler(void)199 void vPortEndScheduler( void )
200 {
201 /* Not implemented - unlikely to ever be required as there is nothing to
202 return to. */
203 }
204 /*-----------------------------------------------------------*/
205
prvSetupTimerInterrupt(void)206 static void prvSetupTimerInterrupt( void )
207 {
208 /* The peripheral clock divided by 32 is used by the timer. */
209 const uint16_t usReloadValue = ( uint16_t ) ( ( ( configPER_CLOCK_HZ / configTICK_RATE_HZ ) / 32UL ) - 1UL );
210
211 /* Setup RLT0 to generate a tick interrupt. */
212
213 TMCSR0_CNTE = 0; /* Count Disable */
214 TMCSR0_CSL = 0x2; /* CLKP/32 */
215 TMCSR0_MOD = 0; /* Software trigger */
216 TMCSR0_RELD = 1; /* Reload */
217
218 TMCSR0_UF = 0; /* Clear underflow flag */
219 TMRLR0 = usReloadValue;
220 TMCSR0_INTE = 1; /* Interrupt Enable */
221 TMCSR0_CNTE = 1; /* Count Enable */
222 TMCSR0_TRG = 1; /* Trigger */
223
224 PORTEN = 0x3; /* Port Enable */
225 }
226 /*-----------------------------------------------------------*/
227
228 #if configUSE_PREEMPTION == 1
229
230 /*
231 * Tick ISR for preemptive scheduler. The tick count is incremented
232 * after the context is saved. Then the context is switched if required,
233 * and last the context of the task which is to be resumed is restored.
234 */
235
236 #pragma asm
237
238 .global _ReloadTimer0_IRQHandler
239 _ReloadTimer0_IRQHandler:
240
241 ANDCCR #0xEF ;Disable Interrupts
242 SaveContext ;Save context
243 ORCCR #0x10 ;Re-enable Interrupts
244
245 LDI #0xFFFB,R1
246 LDI #_tmcsr0, R0
247 AND R1,@R0 ;Clear RLT0 interrupt flag
248
249 CALL32 _xTaskIncrementTick,R12 ;Increment Tick
250 CALL32 _vTaskSwitchContext,R12 ;Switch context if required
251
252 ANDCCR #0xEF ;Disable Interrupts
253 RestoreContext ;Restore context
254 ORCCR #0x10 ;Re-enable Interrupts
255
256 RETI
257
258 #pragma endasm
259
260 #else
261
262 /*
263 * Tick ISR for the cooperative scheduler. All this does is increment the
264 * tick count. We don't need to switch context, this can only be done by
265 * manual calls to taskYIELD();
266 */
267 __interrupt void ReloadTimer0_IRQHandler( void )
268 {
269 /* Clear RLT0 interrupt flag */
270 TMCSR0_UF = 0;
271 xTaskIncrementTick();
272 }
273
274 #endif
275
276 /*
277 * Manual context switch. We can use a __nosavereg attribute as the context
278 * would be saved by PortSAVE_CONTEXT(). The context is switched and then
279 * the context of the new task is restored saved.
280 */
281 #pragma asm
282
283 .global _vPortYieldDelayed
284 _vPortYieldDelayed:
285
286 ANDCCR #0xEF ;Disable Interrupts
287 SaveContext ;Save context
288 ORCCR #0x10 ;Re-enable Interrupts
289
290 LDI #_dicr, R0
291 BANDL #0x0E, @R0 ;Clear Delayed interrupt flag
292
293 CALL32 _vTaskSwitchContext,R12 ;Switch context if required
294
295 ANDCCR #0xEF ;Disable Interrupts
296 RestoreContext ;Restore context
297 ORCCR #0x10 ;Re-enable Interrupts
298
299 RETI
300
301 #pragma endasm
302 /*-----------------------------------------------------------*/
303
304 /*
305 * Manual context switch. We can use a __nosavereg attribute as the context
306 * would be saved by PortSAVE_CONTEXT(). The context is switched and then
307 * the context of the new task is restored saved.
308 */
309 #pragma asm
310
311 .global _vPortYield
312 _vPortYield:
313
314 SaveContext ;Save context
315 CALL32 _vTaskSwitchContext,R12 ;Switch context if required
316 RestoreContext ;Restore context
317
318 RETI
319
320 #pragma endasm
321 /*-----------------------------------------------------------*/
322