git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/RL78_multiple_IAR/ExampleISR.s87

   1 ;    FreeRTOS V9.0.0rc2 - Copyright (C) 2016 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