]> git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/RL78_multiple_IAR/ExampleISR.s87
Update version numbers in preparation for new release.
[freertos] / FreeRTOS / Demo / RL78_multiple_IAR / ExampleISR.s87
1 ;    FreeRTOS V8.2.2 - Copyright (C) 2015 Real Time Engineers Ltd.\r
2 ;\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
5 ;\r
6 ;    ***************************************************************************\r
7 ;     *                                                                       *\r
8 ;     *    FreeRTOS tutorial books are available in pdf and paperback.        *\r
9 ;     *    Complete, revised, and edited pdf reference manuals are also       *\r
10 ;     *    available.                                                         *\r
11 ;     *                                                                       *\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
18 ;     *                                                                       *\r
19 ;     *    >>> See http://www.FreeRTOS.org/Documentation for details. <<<     *\r
20 ;     *                                                                       *\r
21 ;     *    Thank you for using FreeRTOS, and thank you for your support!      *\r
22 ;     *                                                                       *\r
23 ;    ***************************************************************************\r
24 ;\r
25 ;\r
26 ;    This file is part of the FreeRTOS distribution.\r
27 ;\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
31 ;\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
35 ;    kernel.\r
36 ;\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
45 ;\r
46 ;    1 tab == 4 spaces!\r
47 ;\r
48 ;    ***************************************************************************\r
49 ;     *                                                                       *\r
50 ;     *    Having a problem?  Start by reading the FAQ "My application does   *\r
51 ;     *    not run, what could be wrong?"                                     *\r
52 ;     *                                                                       *\r
53 ;     *    http://www.FreeRTOS.org/FAQHelp.html                               *\r
54 ;     *                                                                       *\r
55 ;    ***************************************************************************\r
56 ;\r
57 ;\r
58 ;    http://www.FreeRTOS.org - Documentation, books, training, latest versions,\r
59 ;    license and Real Time Engineers Ltd. contact details.\r
60 ;\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
64 ;\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
68 ;\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
72 \r
73 ;*\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
76 ; *\r
77 \r
78 ; ISR_Support.h contains the definitions of portSAVE_CONTEXT() and\r
79 ; portRESTORE_CONTEXT().\r
80 #include "ISR_Support.h"\r
81 \r
82         PUBLIC vANExampleISR_ASM_Wrapper\r
83         EXTERN vAnExampleISR_C_Handler\r
84 \r
85         RSEG CODE:CODE\r
86 \r
87 ;        *\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
93 ;        *\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
97 ;        * instructions.\r
98 ;        *\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
102 ;        *\r
103 \r
104         vANExampleISR_ASM_Wrapper:\r
105 \r
106 ;               portSAVE_CONTEXT() must be the first thing called in the ASM\r
107 ;               wrapper.\r
108                 portSAVE_CONTEXT\r
109 \r
110 ;               Once the context has been saved the C handler can be called.\r
111                 call !!vAnExampleISR_C_Handler\r
112 \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
118             reti\r
119 \r
120 \r
121 ;   The interrupt handler can be installed into the vector table in the same\r
122 ;    assembly file.\r
123 \r
124 ;   Ensure the vector table segement is used.\r
125         COMMON INTVEC:CODE:ROOT(1)\r
126 ;\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
130         ORG 58\r
131         DW vANExampleISR_ASM_Wrapper\r
132 \r
133         END\r
134 \r