2 ; * FreeRTOS Kernel V10.0.0
\r
3 ; * Copyright (C) 2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
\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
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
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
23 ; * http://www.FreeRTOS.org
\r
24 ; * http://aws.amazon.com/freertos
\r
26 ; * 1 tab == 4 spaces!
\r
30 ; * This file defines the assembler wrapper for the example interrupt that is
\r
31 ; * defined in main.c. The wrapper is the interrupt entry point.
\r
34 ; ISR_Support.h contains the definitions of portSAVE_CONTEXT() and
\r
35 ; portRESTORE_CONTEXT().
\r
36 #include "ISR_Support.h"
\r
38 PUBLIC vANExampleISR_ASM_Wrapper
\r
39 EXTERN vAnExampleISR_C_Handler
\r
44 ; * This demo does not include a functional interrupt service routine - so
\r
45 ; * this dummy handler (which is not actually installed) is provided as an
\r
46 ; * example of how an ISR that needs to cause a context switch needs to be
\r
47 ; * implemented. ISRs that do not cause a context switch have no special
\r
48 ; * requirements and can be written as per the compiler documentation.
\r
50 ; * This assembly wrapper function calls the main handler, which is called
\r
51 ; * vAnExampleISR_C_Handler(), and is implemented in main.c. See the
\r
52 ; * documentation page for this demo on the FreeRTOS.org website for full
\r
55 ; * NOTE: vANExampleISR_ASM_Wrapper needs to be installed into the relevant
\r
56 ; * vector, an example of how to do this from an assembly file is locate at
\r
57 ; * the bottom of this file.
\r
60 vANExampleISR_ASM_Wrapper:
\r
62 ; portSAVE_CONTEXT() must be the first thing called in the ASM
\r
66 ; Once the context has been saved the C handler can be called.
\r
67 call !!vAnExampleISR_C_Handler
\r
69 ; Finally the ISR must end with a call to portRESTORE_CONTEXT()
\r
70 ; followed by a reti instruction to return from the interrupt to whichever
\r
71 ; task is now the task selected to run (which may be different to the task
\r
72 ; that was running before the interrupt started).
\r
77 ; The interrupt handler can be installed into the vector table in the same
\r
80 ; Ensure the vector table segement is used.
\r
81 COMMON INTVEC:CODE:ROOT(1)
\r
83 ; Place a pointer to the asm wrapper at the correct index into the vector
\r
84 ; table. Note 56 is used is purely as an example. The correct vector
\r
85 ; number for the interrupt being installed must be used.
\r
87 DW vANExampleISR_ASM_Wrapper
\r