git.sur5r.net Git - freertos/blob

   1 /******************************************************************************
   2 *
   3 * Copyright (C) 2009 - 2014 Xilinx, Inc.  All rights reserved.
   4 *
   5 * Permission is hereby granted, free of charge, to any person obtaining a copy
   6 * of this software and associated documentation files (the "Software"), to deal
   7 * in the Software without restriction, including without limitation the rights
   8 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
   9 * copies of the Software, and to permit persons to whom the Software is
  10 * furnished to do so, subject to the following conditions:
  11 *
  12 * The above copyright notice and this permission notice shall be included in
  13 * all copies or substantial portions of the Software.
  14 *
  15 * Use of the Software is limited solely to applications:
  16 * (a) running on a Xilinx device, or
  17 * (b) that interact with a Xilinx device through a bus or interconnect.
  18 *
  19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  22 * XILINX  BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  23 * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
  24 * OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  25 * SOFTWARE.
  26 *
  27 * Except as contained in this notice, the name of the Xilinx shall not be used
  28 * in advertising or otherwise to promote the sale, use or other dealings in
  29 * this Software without prior written authorization from Xilinx.
  30 *
  31 ******************************************************************************/
  32 /****************************************************************************/
  33 /**
  34 *
  35 * @file xil_exception.c
  36 *
  37 * This file contains low-level driver functions for the Cortex A9 exception
  38 * Handler.
  39 *
  40 * <pre>
  41 * MODIFICATION HISTORY:
  42 *
  43 * Ver   Who      Date     Changes
  44 * ----- -------- -------- -----------------------------------------------
  45 * 1.00a ecm/sdm  11/04/09 First release
  46 * 3.05a sdm      02/02/12 Updated to resiter a null handler only if a handler
  47 *                         is not already registered
  48 * </pre>
  49 *
  50 *****************************************************************************/
  51
  52 /***************************** Include Files ********************************/
  53
  54 #include "xil_types.h"
  55 #include "xil_assert.h"
  56 #include "xil_exception.h"
  57 #include "xpseudo_asm.h"
  58
  59 /************************** Constant Definitions ****************************/
  60
  61 /**************************** Type Definitions ******************************/
  62
  63 typedef struct {
  64         Xil_ExceptionHandler Handler;
  65         void *Data;
  66 } XExc_VectorTableEntry;
  67
  68 /***************** Macros (Inline Functions) Definitions ********************/
  69
  70 /************************** Function Prototypes *****************************/
  71
  72 /************************** Variable Definitions *****************************/
  73 /*
  74  * Exception vector table to store handlers for each exception vector.
  75  */
  76 XExc_VectorTableEntry XExc_VectorTable[XIL_EXCEPTION_ID_LAST + 1];
  77
  78 /*****************************************************************************/
  79
  80 /****************************************************************************/
  81 /**
  82 *
  83 * This function is a stub Handler that is the default Handler that gets called
  84 * if the application has not setup a Handler for a specific  exception. The
  85 * function interface has to match the interface specified for a Handler even
  86 * though none of the arguments are used.
  87 *
  88 * @param        Data is unused by this function.
  89 *
  90 * @return       None.
  91 *
  92 * @note         None.
  93 *
  94 *****************************************************************************/
  95 static void Xil_ExceptionNullHandler(void *Data)
  96 {
  97         (void)Data;
  98 DieLoop: goto DieLoop;
  99 }
 100
 101 /****************************************************************************/
 102 /**
 103 *
 104 * Initialize exception handling for the Processor. The exception vector table
 105 * is setup with the stub Handler for all exceptions.
 106 *
 107 * @param        None.
 108 *
 109 * @return       None.
 110 *
 111 * @note         None.
 112 *
 113 *****************************************************************************/
 114 void Xil_ExceptionInit(void)
 115 {
 116         unsigned long index;
 117
 118         /*
 119          * Initialize the vector table. Register the stub Handler for each
 120          * exception.
 121          */
 122         for(index = XIL_EXCEPTION_ID_FIRST; index < XIL_EXCEPTION_ID_LAST + 1;
 123             index++) {
 124                 if (XExc_VectorTable[index].Handler == NULL) {
 125                         Xil_ExceptionRegisterHandler(index,
 126                                                      Xil_ExceptionNullHandler,
 127                                                      NULL);
 128                 }
 129         }
 130 }
 131
 132 /*****************************************************************************/
 133 /**
 134 *
 135 * Makes the connection between the Id of the exception source and the
 136 * associated Handler that is to run when the exception is recognized. The
 137 * argument provided in this call as the Data is used as the argument
 138 * for the Handler when it is called.
 139 *
 140 * @param        exception_id contains the ID of the exception source and should
 141 *               be in the range of 0 to XIL_EXCEPTION_ID_LAST.
 142                 See xil_exception_l.h for further information.
 143 * @param        Handler to the Handler for that exception.
 144 * @param        Data is a reference to Data that will be passed to the
 145 *               Handler when it gets called.
 146 *
 147 * @return       None.
 148 *
 149 * @note         None.
 150 *
 151 ****************************************************************************/
 152 void Xil_ExceptionRegisterHandler(u32 exception_id,
 153                                     Xil_ExceptionHandler Handler,
 154                                     void *Data)
 155 {
 156         XExc_VectorTable[exception_id].Handler = Handler;
 157         XExc_VectorTable[exception_id].Data = Data;
 158 }
 159
 160 /*****************************************************************************/
 161 /**
 162 *
 163 * Removes the Handler for a specific exception Id. The stub Handler is then
 164 * registered for this exception Id.
 165 *
 166 * @param        exception_id contains the ID of the exception source and should
 167 *               be in the range of 0 to XIL_EXCEPTION_ID_LAST.
 168 *               See xil_exception_l.h for further information.
 169
 170 * @return       None.
 171 *
 172 * @note         None.
 173 *
 174 ****************************************************************************/
 175 void Xil_ExceptionRemoveHandler(u32 exception_id)
 176 {
 177         Xil_ExceptionRegisterHandler(exception_id,
 178                                        Xil_ExceptionNullHandler,
 179                                        NULL);
 180 }