git.sur5r.net Git - freertos/blob

   1 /******************************************************************************
   2 *
   3 * (c) Copyright 2010-2014 Xilinx, Inc. All rights reserved.
   4 *
   5 * This file contains confidential and proprietary information of Xilinx, Inc.
   6 * and is protected under U.S. and international copyright and other
   7 * intellectual property laws.
   8 *
   9 * DISCLAIMER
  10 * This disclaimer is not a license and does not grant any rights to the
  11 * materials distributed herewith. Except as otherwise provided in a valid
  12 * license issued to you by Xilinx, and to the maximum extent permitted by
  13 * applicable law: (1) THESE MATERIALS ARE MADE AVAILABLE "AS IS" AND WITH ALL
  14 * FAULTS, AND XILINX HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS,
  15 * IMPLIED, OR STATUTORY, INCLUDING BUT NOT LIMITED TO WARRANTIES OF
  16 * MERCHANTABILITY, NON-INFRINGEMENT, OR FITNESS FOR ANY PARTICULAR PURPOSE;
  17 * and (2) Xilinx shall not be liable (whether in contract or tort, including
  18 * negligence, or under any other theory of liability) for any loss or damage
  19 * of any kind or nature related to, arising under or in connection with these
  20 * materials, including for any direct, or any indirect, special, incidental,
  21 * or consequential loss or damage (including loss of data, profits, goodwill,
  22 * or any type of loss or damage suffered as a result of any action brought by
  23 * a third party) even if such damage or loss was reasonably foreseeable or
  24 * Xilinx had been advised of the possibility of the same.
  25 *
  26 * CRITICAL APPLICATIONS
  27 * Xilinx products are not designed or intended to be fail-safe, or for use in
  28 * any application requiring fail-safe performance, such as life-support or
  29 * safety devices or systems, Class III medical devices, nuclear facilities,
  30 * applications related to the deployment of airbags, or any other applications
  31 * that could lead to death, personal injury, or severe property or
  32 * environmental damage (individually and collectively, "Critical
  33 * Applications"). Customer assumes the sole risk and liability of any use of
  34 * Xilinx products in Critical Applications, subject only to applicable laws
  35 * and regulations governing limitations on product liability.
  36 *
  37 * THIS COPYRIGHT NOTICE AND DISCLAIMER MUST BE RETAINED AS PART OF THIS FILE
  38 * AT ALL TIMES.
  39 *
  40 ******************************************************************************/
  41 /*****************************************************************************/
  42 /**
  43 *
  44 * @file xscugic_intr.c
  45 *
  46 * This file contains the interrupt processing for the driver for the Xilinx
  47 * Interrupt Controller.  The interrupt processing is partitioned separately such
  48 * that users are not required to use the provided interrupt processing.  This
  49 * file requires other files of the driver to be linked in also.
  50 *
  51 * The interrupt handler, XScuGic_InterruptHandler, uses an input argument which
  52 * is an instance pointer to an interrupt controller driver such that multiple
  53 * interrupt controllers can be supported.  This handler requires the calling
  54 * function to pass it the appropriate argument, so another level of indirection
  55 * may be required.
  56 *
  57 * The interrupt processing may be used by connecting the interrupt handler to
  58 * the interrupt system.  The handler does not save and restore the processor
  59 * context but only handles the processing of the Interrupt Controller. The user
  60 * is encouraged to supply their own interrupt handler when performance tuning is
  61 * deemed necessary.
  62 *
  63 * <pre>
  64 * MODIFICATION HISTORY:
  65 *
  66 * Ver   Who  Date     Changes
  67 * ----- ---- -------- ---------------------------------------------------------
  68 * 1.00a drg  01/19/10 First release
  69 * 1.01a sdm  11/09/11 XScuGic_InterruptHandler has changed correspondingly
  70 *                     since the HandlerTable has now moved to XScuGic_Config.
  71 *
  72 * </pre>
  73 *
  74 * @internal
  75 *
  76 * This driver assumes that the context of the processor has been saved prior to
  77 * the calling of the Interrupt Controller interrupt handler and then restored
  78 * after the handler returns. This requires either the running RTOS to save the
  79 * state of the machine or that a wrapper be used as the destination of the
  80 * interrupt vector to save the state of the processor and restore the state
  81 * after the interrupt handler returns.
  82 *
  83 ******************************************************************************/
  84
  85 /***************************** Include Files *********************************/
  86
  87 #include "xil_types.h"
  88 #include "xil_assert.h"
  89 #include "xscugic.h"
  90
  91 /************************** Constant Definitions *****************************/
  92
  93 /**************************** Type Definitions *******************************/
  94
  95 /***************** Macros (Inline Functions) Definitions *********************/
  96
  97 /************************** Function Prototypes ******************************/
  98
  99 /************************** Variable Definitions *****************************/
 100
 101 /*****************************************************************************/
 102 /**
 103 * This function is the primary interrupt handler for the driver.  It must be
 104 * connected to the interrupt source such that it is called when an interrupt of
 105 * the interrupt controller is active. It will resolve which interrupts are
 106 * active and enabled and call the appropriate interrupt handler. It uses
 107 * the Interrupt Type information to determine when to acknowledge the interrupt.
 108 * Highest priority interrupts are serviced first.
 109 *
 110 * This function assumes that an interrupt vector table has been previously
 111 * initialized.  It does not verify that entries in the table are valid before
 112 * calling an interrupt handler.
 113 *
 114 *
 115 * @param        InstancePtr is a pointer to the XScuGic instance.
 116 *
 117 * @return       None.
 118 *
 119 * @note         None.
 120 *
 121 ******************************************************************************/
 122 void XScuGic_InterruptHandler(XScuGic *InstancePtr)
 123 {
 124
 125     u32 IntID;
 126             u32 IntIDFull;
 127             XScuGic_VectorTableEntry *TablePtr;
 128
 129             /* Assert that the pointer to the instance is valid
 130              */
 131             Xil_AssertVoid(InstancePtr != NULL);
 132
 133             /*
 134              * Read the int_ack register to identify the highest priority interrupt ID
 135              * and make sure it is valid. Reading Int_Ack will clear the interrupt
 136              * in the GIC.
 137              */
 138             IntIDFull = XScuGic_CPUReadReg(InstancePtr, XSCUGIC_INT_ACK_OFFSET);
 139             IntID = IntIDFull & XSCUGIC_ACK_INTID_MASK;
 140
 141             if(XSCUGIC_MAX_NUM_INTR_INPUTS < IntID){
 142                 goto IntrExit;
 143             }
 144
 145             /*
 146              * If the interrupt is shared, do some locking here if there are multiple
 147              * processors.
 148              */
 149             /*
 150              * If pre-eption is required:
 151              * Re-enable pre-emption by setting the CPSR I bit for non-secure ,
 152              * interrupts or the F bit for secure interrupts
 153              */
 154
 155             /*
 156              * If we need to change security domains, issue a SMC instruction here.
 157              */
 158
 159             /*
 160              * Execute the ISR. Jump into the Interrupt service routine based on the
 161              * IRQSource. A software trigger is cleared by the ACK.
 162              */
 163                 TablePtr = &(InstancePtr->Config->HandlerTable[IntID]);
 164                 TablePtr->Handler(TablePtr->CallBackRef);
 165
 166         IntrExit:
 167             /*
 168              * Write to the EOI register, we are all done here.
 169              * Let this function return, the boot code will restore the stack.
 170              */
 171             XScuGic_CPUWriteReg(InstancePtr, XSCUGIC_EOI_OFFSET, IntIDFull);
 172
 173             /*
 174              * Return from the interrupt. Change security domains could happen here.
 175      */
 176 }