2 ; * FreeRTOS Kernel V10.0.1
\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.
\r
15 ; * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
\r
16 ; * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
\r
17 ; * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
\r
18 ; * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
\r
19 ; * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
\r
20 ; * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
\r
22 ; * http://www.FreeRTOS.org
\r
23 ; * http://aws.amazon.com/freertos
\r
25 ; * 1 tab == 4 spaces!
\r
29 ; * This file defines the assembler wrapper for the example interrupt that is
\r
30 ; * defined in main.c. The wrapper is the interrupt entry point.
\r
33 ; ISR_Support.h contains the definitions of portSAVE_CONTEXT() and
\r
34 ; portRESTORE_CONTEXT().
\r
35 #include "ISR_Support.h"
\r
37 PUBLIC vANExampleISR_ASM_Wrapper
\r
38 EXTERN vAnExampleISR_C_Handler
\r
43 ; * This demo does not include a functional interrupt service routine - so
\r
44 ; * this dummy handler (which is not actually installed) is provided as an
\r
45 ; * example of how an ISR that needs to cause a context switch needs to be
\r
46 ; * implemented. ISRs that do not cause a context switch have no special
\r
47 ; * requirements and can be written as per the compiler documentation.
\r
49 ; * This assembly wrapper function calls the main handler, which is called
\r
50 ; * vAnExampleISR_C_Handler(), and is implemented in main.c. See the
\r
51 ; * documentation page for this demo on the FreeRTOS.org website for full
\r
54 ; * NOTE: vANExampleISR_ASM_Wrapper needs to be installed into the relevant
\r
55 ; * vector, an example of how to do this from an assembly file is locate at
\r
56 ; * the bottom of this file.
\r
59 vANExampleISR_ASM_Wrapper:
\r
61 ; portSAVE_CONTEXT() must be the first thing called in the ASM
\r
65 ; Once the context has been saved the C handler can be called.
\r
66 call !!vAnExampleISR_C_Handler
\r
68 ; Finally the ISR must end with a call to portRESTORE_CONTEXT()
\r
69 ; followed by a reti instruction to return from the interrupt to whichever
\r
70 ; task is now the task selected to run (which may be different to the task
\r
71 ; that was running before the interrupt started).
\r
76 ; The interrupt handler can be installed into the vector table in the same
\r
79 ; Ensure the vector table segement is used.
\r
80 COMMON INTVEC:CODE:ROOT(1)
\r
82 ; Place a pointer to the asm wrapper at the correct index into the vector
\r
83 ; table. Note 56 is used is purely as an example. The correct vector
\r
84 ; number for the interrupt being installed must be used.
\r
86 DW vANExampleISR_ASM_Wrapper
\r