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

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