git.sur5r.net Git - freertos/blob

   1 /******************************************************************************
   2 *
   3 * Copyright (C) 2014 - 2015 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 A53 exception
  38 * Handler.
  39 *
  40 * <pre>
  41 * MODIFICATION HISTORY:
  42 *
  43 * Ver   Who      Date     Changes
  44 * ----- -------- -------- -----------------------------------------------
  45 * 5.00  pkp  05/29/14 First release
  46 * </pre>
  47 *
  48 *****************************************************************************/
  49
  50 /***************************** Include Files ********************************/
  51
  52 #include "xil_types.h"
  53 #include "xil_assert.h"
  54 #include "xil_exception.h"
  55 #include "xpseudo_asm.h"
  56 #include "xdebug.h"
  57 /************************** Constant Definitions ****************************/
  58
  59 /**************************** Type Definitions ******************************/
  60
  61 typedef struct {
  62         Xil_ExceptionHandler Handler;
  63         void *Data;
  64 } XExc_VectorTableEntry;
  65
  66 /***************** Macros (Inline Functions) Definitions ********************/
  67
  68 /************************** Function Prototypes *****************************/
  69
  70 static void Xil_ExceptionNullHandler(void *Data);
  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         {Xil_ExceptionNullHandler, NULL},
  79         {Xil_SyncAbortHandler, NULL},
  80         {Xil_ExceptionNullHandler, NULL},
  81         {Xil_ExceptionNullHandler, NULL},
  82         {Xil_SErrorAbortHandler, NULL},
  83
  84 };
  85 /****************************************************************************/
  86 /**
  87 *
  88 * This function is a stub Handler that is the default Handler that gets called
  89 * if the application has not setup a Handler for a specific  exception. The
  90 * function interface has to match the interface specified for a Handler even
  91 * though none of the arguments are used.
  92 *
  93 * @param        Data is unused by this function.
  94 *
  95 * @return       None.
  96 *
  97 * @note         None.
  98 *
  99 *****************************************************************************/
 100 static void Xil_ExceptionNullHandler(void *Data)
 101 {
 102         (void *)Data;
 103 DieLoop: goto DieLoop;
 104 }
 105
 106 /****************************************************************************/
 107 /**
 108 *
 109 * The function is a common API used to initialize exception handlers across all
 110 * processors supported. For ARM CortexA53, the exception handlers are being
 111 * initialized statically and hence this function does not do anything.
 112 *
 113 *
 114 * @param        None.
 115 *
 116 * @return       None.
 117 *
 118 * @note         None.
 119 *
 120 *****************************************************************************/
 121 void Xil_ExceptionInit(void)
 122 {
 123         return;
 124 }
 125
 126 /*****************************************************************************/
 127 /**
 128 *
 129 * Makes the connection between the Id of the exception source and the
 130 * associated Handler that is to run when the exception is recognized. The
 131 * argument provided in this call as the Data is used as the argument
 132 * for the Handler when it is called.
 133 *
 134 * @param        exception_id contains the ID of the exception source and should
 135 *               be in the range of 0 to XIL_EXCEPTION_ID_LAST.
 136                 See xil_exception_l.h for further information.
 137 * @param        Handler to the Handler for that exception.
 138 * @param        Data is a reference to Data that will be passed to the
 139 *               Handler when it gets called.
 140 *
 141 * @return       None.
 142 *
 143 * @note         None.
 144 *
 145 ****************************************************************************/
 146 void Xil_ExceptionRegisterHandler(u32 Exception_id,
 147                                     Xil_ExceptionHandler Handler,
 148                                     void *Data)
 149 {
 150         XExc_VectorTable[Exception_id].Handler = Handler;
 151         XExc_VectorTable[Exception_id].Data = Data;
 152 }
 153
 154 /*****************************************************************************/
 155 /**
 156 *
 157 * Removes the Handler for a specific exception Id. The stub Handler is then
 158 * registered for this exception Id.
 159 *
 160 * @param        exception_id contains the ID of the exception source and should
 161 *               be in the range of 0 to XIL_EXCEPTION_ID_LAST.
 162 *               See xil_exception_l.h for further information.
 163
 164 * @return       None.
 165 *
 166 * @note         None.
 167 *
 168 ****************************************************************************/
 169 void Xil_ExceptionRemoveHandler(u32 Exception_id)
 170 {
 171         Xil_ExceptionRegisterHandler(Exception_id,
 172                                        Xil_ExceptionNullHandler,
 173                                        NULL);
 174 }
 175 /*****************************************************************************/
 176 /**
 177 *
 178 * Default Synchronous abort handler which prints a debug message on console if
 179 * Debug flag is enabled
 180 *
 181 * @param        None
 182 *
 183 * @return       None.
 184 *
 185 * @note         None.
 186 *
 187 ****************************************************************************/
 188
 189 void Xil_SyncAbortHandler(void *CallBackRef){
 190         xdbg_printf(XDBG_DEBUG_ERROR, "Synchronous abort \n");
 191         while(1) {
 192                 ;
 193         }
 194 }
 195
 196 /*****************************************************************************/
 197 /**
 198 *
 199 * Default SError abort handler which prints a debug message on console if
 200 * Debug flag is enabled
 201 *
 202 * @param        None
 203 *
 204 * @return       None.
 205 *
 206 * @note         None.
 207 *
 208 ****************************************************************************/
 209 void Xil_SErrorAbortHandler(void *CallBackRef){
 210         xdbg_printf(XDBG_DEBUG_ERROR, "Synchronous abort \n");
 211         while(1) {
 212                 ;
 213         }
 214 }