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

   1 ;/*\r
   2 ; * FreeRTOS Kernel V10.0.0\r
   3 ; * Copyright (C) 2017 Amazon.com, Inc. or its affiliates.  All Rights Reserved.\r
   4 ; *\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
  11 ; *\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
  15 ; *\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
  22 ; *\r
  23 ; * http://www.FreeRTOS.org\r
  24 ; * http://aws.amazon.com/freertos\r
  25 ; *\r
  26 ; * 1 tab == 4 spaces!\r
  27 ; */\r
  28 \r
  29 ;*\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
  32 ; *\r
  33 \r
  34 ; ISR_Support.h contains the definitions of portSAVE_CONTEXT() and\r
  35 ; portRESTORE_CONTEXT().\r
  36 #include "ISR_Support.h"\r
  37 \r
  38         PUBLIC vANExampleISR_ASM_Wrapper\r
  39         EXTERN vAnExampleISR_C_Handler\r
  40 \r
  41         RSEG CODE:CODE\r
  42 \r
  43 ;        *\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
  49 ;        *\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
  53 ;        * instructions.\r
  54 ;        *\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
  58 ;        *\r
  59 \r
  60         vANExampleISR_ASM_Wrapper:\r
  61 \r
  62 ;               portSAVE_CONTEXT() must be the first thing called in the ASM\r
  63 ;               wrapper.\r
  64                 portSAVE_CONTEXT\r
  65 \r
  66 ;               Once the context has been saved the C handler can be called.\r
  67                 call !!vAnExampleISR_C_Handler\r
  68 \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
  73             portRESTORE_CONTEXT\r
  74             reti\r
  75 \r
  76 \r
  77 ;   The interrupt handler can be installed into the vector table in the same\r
  78 ;    assembly file.\r
  79 \r
  80 ;   Ensure the vector table segement is used.\r
  81         COMMON INTVEC:CODE:ROOT(1)\r
  82 ;\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
  86         ORG 58\r
  87         DW vANExampleISR_ASM_Wrapper\r
  88 \r
  89         END\r
  90 \r