1 /******************************************************************************
3 * Copyright (C) 2015 - 2016 Xilinx, Inc. All rights reserved.
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:
12 * The above copyright notice and this permission notice shall be included in
13 * all copies or substantial portions of the Software.
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.
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
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.
31 ******************************************************************************/
32 /****************************************************************************/
35 * @file xil_exception.c
37 * This file contains low-level driver functions for the Cortex A53,A9,R5 exception
41 * MODIFICATION HISTORY:
43 * Ver Who Date Changes
44 * ----- -------- -------- -----------------------------------------------
45 * 5.2 pkp 28/05/15 First release
46 * 6.0 mus 27/07/16 Consolidated exceptions for a53,a9 and r5
47 * processors and added Xil_UndefinedExceptionHandler
48 * for a53 32 bit and r5 as well.
51 *****************************************************************************/
53 /***************************** Include Files ********************************/
55 #include "xil_types.h"
56 #include "xil_assert.h"
57 #include "xil_exception.h"
58 #include "xpseudo_asm.h"
60 /************************** Constant Definitions ****************************/
62 /**************************** Type Definitions ******************************/
65 Xil_ExceptionHandler Handler;
67 } XExc_VectorTableEntry;
69 /***************** Macros (Inline Functions) Definitions ********************/
71 /************************** Function Prototypes *****************************/
72 static void Xil_ExceptionNullHandler(void *Data);
73 /************************** Variable Definitions *****************************/
75 * Exception vector table to store handlers for each exception vector.
77 #if defined (__aarch64__)
78 XExc_VectorTableEntry XExc_VectorTable[XIL_EXCEPTION_ID_LAST + 1] =
80 {Xil_ExceptionNullHandler, NULL},
81 {Xil_SyncAbortHandler, NULL},
82 {Xil_ExceptionNullHandler, NULL},
83 {Xil_ExceptionNullHandler, NULL},
84 {Xil_SErrorAbortHandler, NULL},
88 XExc_VectorTableEntry XExc_VectorTable[XIL_EXCEPTION_ID_LAST + 1] =
90 {Xil_ExceptionNullHandler, NULL},
91 {Xil_UndefinedExceptionHandler, NULL},
92 {Xil_ExceptionNullHandler, NULL},
93 {Xil_PrefetchAbortHandler, NULL},
94 {Xil_DataAbortHandler, NULL},
95 {Xil_ExceptionNullHandler, NULL},
96 {Xil_ExceptionNullHandler, NULL},
99 #if !defined (__aarch64__)
100 u32 DataAbortAddr; /* Address of instruction causing data abort */
101 u32 PrefetchAbortAddr; /* Address of instruction causing prefetch abort */
102 u32 UndefinedExceptionAddr; /* Address of instruction causing Undefined
106 /*****************************************************************************/
108 /****************************************************************************/
111 * This function is a stub Handler that is the default Handler that gets called
112 * if the application has not setup a Handler for a specific exception. The
113 * function interface has to match the interface specified for a Handler even
114 * though none of the arguments are used.
116 * @param Data is unused by this function.
122 *****************************************************************************/
123 static void Xil_ExceptionNullHandler(void *Data)
126 DieLoop: goto DieLoop;
129 /****************************************************************************/
131 * The function is a common API used to initialize exception handlers across all
132 * processors supported. For ARM CortexA53,R5,A9, the exception handlers are being
133 * initialized statically and hence this function does not do anything.
134 * However, it is still present to avoid any compilation issues in case an
135 * application uses this API and also to take care of backward compatibility
136 * issues (in earlier versions of BSPs, this API was being used to initialize
137 * exception handlers).
145 *****************************************************************************/
146 void Xil_ExceptionInit(void)
151 /*****************************************************************************/
154 * Makes the connection between the Id of the exception source and the
155 * associated Handler that is to run when the exception is recognized. The
156 * argument provided in this call as the Data is used as the argument
157 * for the Handler when it is called.
159 * @param exception_id contains the ID of the exception source and should
160 * be in the range of 0 to XIL_EXCEPTION_ID_LAST.
161 See xil_exception_l.h for further information.
162 * @param Handler to the Handler for that exception.
163 * @param Data is a reference to Data that will be passed to the
164 * Handler when it gets called.
170 ****************************************************************************/
171 void Xil_ExceptionRegisterHandler(u32 Exception_id,
172 Xil_ExceptionHandler Handler,
175 XExc_VectorTable[Exception_id].Handler = Handler;
176 XExc_VectorTable[Exception_id].Data = Data;
179 /*****************************************************************************/
182 * Removes the Handler for a specific exception Id. The stub Handler is then
183 * registered for this exception Id.
185 * @param exception_id contains the ID of the exception source and should
186 * be in the range of 0 to XIL_EXCEPTION_ID_LAST.
187 * See xil_exception_l.h for further information.
193 ****************************************************************************/
194 void Xil_ExceptionRemoveHandler(u32 Exception_id)
196 Xil_ExceptionRegisterHandler(Exception_id,
197 Xil_ExceptionNullHandler,
201 #if defined (__aarch64__)
202 /*****************************************************************************/
205 * Default Synchronous abort handler which prints a debug message on console if
206 * Debug flag is enabled
214 ****************************************************************************/
216 void Xil_SyncAbortHandler(void *CallBackRef){
217 xdbg_printf(XDBG_DEBUG_ERROR, "Synchronous abort \n");
223 /*****************************************************************************/
226 * Default SError abort handler which prints a debug message on console if
227 * Debug flag is enabled
235 ****************************************************************************/
236 void Xil_SErrorAbortHandler(void *CallBackRef){
237 xdbg_printf(XDBG_DEBUG_ERROR, "Synchronous abort \n");
243 /*****************************************************************************/
246 * Default Data abort handler which prints data fault status register through
247 * which information about data fault can be acquired
255 ****************************************************************************/
257 void Xil_DataAbortHandler(void *CallBackRef){
261 xdbg_printf(XDBG_DEBUG_ERROR, "Data abort \n");
263 FaultStatus = mfcp(XREG_CP15_DATA_FAULT_STATUS);
264 #elif defined (__ICCARM__)
265 mfcp(XREG_CP15_DATA_FAULT_STATUS,FaultStatus);
267 { volatile register u32 Reg __asm(XREG_CP15_DATA_FAULT_STATUS);
270 xdbg_printf(XDBG_DEBUG_GENERAL, "Data abort with Data Fault Status Register %x\n",FaultStatus);
271 xdbg_printf(XDBG_DEBUG_GENERAL, "Address of Instrcution causing Data abort %x\n",DataAbortAddr);
278 /*****************************************************************************/
281 * Default Prefetch abort handler which prints prefetch fault status register through
282 * which information about instruction prefetch fault can be acquired
290 ****************************************************************************/
291 void Xil_PrefetchAbortHandler(void *CallBackRef){
295 xdbg_printf(XDBG_DEBUG_ERROR, "Prefetch abort \n");
297 FaultStatus = mfcp(XREG_CP15_INST_FAULT_STATUS);
298 #elif defined (__ICCARM__)
299 mfcp(XREG_CP15_INST_FAULT_STATUS,FaultStatus);
301 { volatile register u32 Reg __asm(XREG_CP15_INST_FAULT_STATUS);
304 xdbg_printf(XDBG_DEBUG_GENERAL, "Prefetch abort with Instruction Fault Status Register %x\n",FaultStatus);
305 xdbg_printf(XDBG_DEBUG_GENERAL, "Address of Instrcution causing Prefetch abort %x\n",PrefetchAbortAddr);
311 /*****************************************************************************/
314 * Default undefined exception handler which prints address of the undefined
315 * instruction if debug prints are enabled
323 ****************************************************************************/
324 void Xil_UndefinedExceptionHandler(void *CallBackRef){
326 xdbg_printf(XDBG_DEBUG_GENERAL, "Address of the undefined instruction %x\n",UndefinedExceptionAddr);