1 ; FreeRTOS V8.2.2 - Copyright (C) 2015 Real Time Engineers Ltd.
\r
3 ; FEATURES AND PORTS ARE ADDED TO FREERTOS ALL THE TIME. PLEASE VISIT
\r
4 ; http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
\r
6 ; ***************************************************************************
\r
8 ; * FreeRTOS tutorial books are available in pdf and paperback. *
\r
9 ; * Complete, revised, and edited pdf reference manuals are also *
\r
12 ; * Purchasing FreeRTOS documentation will not only help you, by *
\r
13 ; * ensuring you get running as quickly as possible and with an *
\r
14 ; * in-depth knowledge of how to use FreeRTOS, it will also help *
\r
15 ; * the FreeRTOS project to continue with its mission of providing *
\r
16 ; * professional grade, cross platform, de facto standard solutions *
\r
17 ; * for microcontrollers - completely free of charge! *
\r
19 ; * >>> See http://www.FreeRTOS.org/Documentation for details. <<< *
\r
21 ; * Thank you for using FreeRTOS, and thank you for your support! *
\r
23 ; ***************************************************************************
\r
26 ; This file is part of the FreeRTOS distribution.
\r
28 ; FreeRTOS is free software; you can redistribute it and/or modify it under
\r
29 ; the terms of the GNU General Public License (version 2) as published by the
\r
30 ; Free Software Foundation AND MODIFIED BY the FreeRTOS exception.
\r
32 ; >>>>>>NOTE<<<<<< The modification to the GPL is included to allow you to
\r
33 ; distribute a combined work that includes FreeRTOS without being obliged to
\r
34 ; provide the source code for proprietary components outside of the FreeRTOS
\r
37 ; FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
\r
38 ; WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
\r
39 ; FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
\r
40 ; details. You should have received a copy of the GNU General Public License
\r
41 ; and the FreeRTOS license exception along with FreeRTOS; if not it can be
\r
42 ; viewed here: http://www.freertos.org/a00114.html and also obtained by
\r
43 ; writing to Real Time Engineers Ltd., contact details for whom are available
\r
44 ; on the FreeRTOS WEB site.
\r
46 ; 1 tab == 4 spaces!
\r
48 ; ***************************************************************************
\r
50 ; * Having a problem? Start by reading the FAQ "My application does *
\r
51 ; * not run, what could be wrong?" *
\r
53 ; * http://www.FreeRTOS.org/FAQHelp.html *
\r
55 ; ***************************************************************************
\r
58 ; http://www.FreeRTOS.org - Documentation, books, training, latest versions,
\r
59 ; license and Real Time Engineers Ltd. contact details.
\r
61 ; http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
\r
62 ; including FreeRTOS+Trace - an indispensable productivity tool, and our new
\r
63 ; fully thread aware and reentrant UDP/IP stack.
\r
65 ; http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High
\r
66 ; Integrity Systems, who sell the code with commercial support,
\r
67 ; indemnification and middleware, under the OpenRTOS brand.
\r
69 ; http://www.SafeRTOS.com - High Integrity Systems also provide a safety
\r
70 ; engineered and independently SIL3 certified version for use in safety and
\r
71 ; mission critical applications that require provable dependability.
\r
74 ; * This file defines the assembler wrapper for the example interrupt that is
\r
75 ; * defined in main.c. The wrapper is the interrupt entry point.
\r
78 ; ISR_Support.h contains the definitions of portSAVE_CONTEXT() and
\r
79 ; portRESTORE_CONTEXT().
\r
80 #include "ISR_Support.h"
\r
82 PUBLIC vANExampleISR_ASM_Wrapper
\r
83 EXTERN vAnExampleISR_C_Handler
\r
88 ; * This demo does not include a functional interrupt service routine - so
\r
89 ; * this dummy handler (which is not actually installed) is provided as an
\r
90 ; * example of how an ISR that needs to cause a context switch needs to be
\r
91 ; * implemented. ISRs that do not cause a context switch have no special
\r
92 ; * requirements and can be written as per the compiler documentation.
\r
94 ; * This assembly wrapper function calls the main handler, which is called
\r
95 ; * vAnExampleISR_C_Handler(), and is implemented in main.c. See the
\r
96 ; * documentation page for this demo on the FreeRTOS.org website for full
\r
99 ; * NOTE: vANExampleISR_ASM_Wrapper needs to be installed into the relevant
\r
100 ; * vector, an example of how to do this from an assembly file is locate at
\r
101 ; * the bottom of this file.
\r
104 vANExampleISR_ASM_Wrapper:
\r
106 ; portSAVE_CONTEXT() must be the first thing called in the ASM
\r
110 ; Once the context has been saved the C handler can be called.
\r
111 call !!vAnExampleISR_C_Handler
\r
113 ; Finally the ISR must end with a call to portRESTORE_CONTEXT()
\r
114 ; followed by a reti instruction to return from the interrupt to whichever
\r
115 ; task is now the task selected to run (which may be different to the task
\r
116 ; that was running before the interrupt started).
\r
117 portRESTORE_CONTEXT
\r
121 ; The interrupt handler can be installed into the vector table in the same
\r
124 ; Ensure the vector table segement is used.
\r
125 COMMON INTVEC:CODE:ROOT(1)
\r
127 ; Place a pointer to the asm wrapper at the correct index into the vector
\r
128 ; table. Note 56 is used is purely as an example. The correct vector
\r
129 ; number for the interrupt being installed must be used.
\r
131 DW vANExampleISR_ASM_Wrapper
\r