mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

cmsis/TARGET_CORTEX_M/mbed_fault_handler.h@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 189:f392fc9709a3 1 /* mbed Microcontroller Library
AnnaBridge 189:f392fc9709a3 2 * Copyright (c) 2006-2018 ARM Limited
AnnaBridge 189:f392fc9709a3 3 *
AnnaBridge 189:f392fc9709a3 4 * Licensed under the Apache License, Version 2.0 (the "License");
AnnaBridge 189:f392fc9709a3 5 * you may not use this file except in compliance with the License.
AnnaBridge 189:f392fc9709a3 6 * You may obtain a copy of the License at
AnnaBridge 189:f392fc9709a3 7 *
AnnaBridge 189:f392fc9709a3 8 * http://www.apache.org/licenses/LICENSE-2.0
AnnaBridge 189:f392fc9709a3 9 *
AnnaBridge 189:f392fc9709a3 10 * Unless required by applicable law or agreed to in writing, software
AnnaBridge 189:f392fc9709a3 11 * distributed under the License is distributed on an "AS IS" BASIS,
AnnaBridge 189:f392fc9709a3 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
AnnaBridge 189:f392fc9709a3 13 * See the License for the specific language governing permissions and
AnnaBridge 189:f392fc9709a3 14 * limitations under the License.
AnnaBridge 189:f392fc9709a3 15 */
AnnaBridge 189:f392fc9709a3 16
AnnaBridge 189:f392fc9709a3 17 #ifndef MBED_FAULT_HANDLER_H
AnnaBridge 189:f392fc9709a3 18 #define MBED_FAULT_HANDLER_H
AnnaBridge 189:f392fc9709a3 19
AnnaBridge 189:f392fc9709a3 20 #ifdef __cplusplus
AnnaBridge 189:f392fc9709a3 21 extern "C" {
AnnaBridge 189:f392fc9709a3 22 #endif
AnnaBridge 189:f392fc9709a3 23
AnnaBridge 189:f392fc9709a3 24 //Fault context struct
AnnaBridge 189:f392fc9709a3 25 //WARNING: DO NOT CHANGE THIS STRUCT WITHOUT MAKING CORRESPONDING CHANGES in except.S files.
AnnaBridge 189:f392fc9709a3 26 //Offset of these registers are used by fault handler in except.S
AnnaBridge 189:f392fc9709a3 27 typedef struct {
AnnaBridge 189:f392fc9709a3 28 uint32_t R0_reg;
AnnaBridge 189:f392fc9709a3 29 uint32_t R1_reg;
AnnaBridge 189:f392fc9709a3 30 uint32_t R2_reg;
AnnaBridge 189:f392fc9709a3 31 uint32_t R3_reg;
AnnaBridge 189:f392fc9709a3 32 uint32_t R4_reg;
AnnaBridge 189:f392fc9709a3 33 uint32_t R5_reg;
AnnaBridge 189:f392fc9709a3 34 uint32_t R6_reg;
AnnaBridge 189:f392fc9709a3 35 uint32_t R7_reg;
AnnaBridge 189:f392fc9709a3 36 uint32_t R8_reg;
AnnaBridge 189:f392fc9709a3 37 uint32_t R9_reg;
AnnaBridge 189:f392fc9709a3 38 uint32_t R10_reg;
AnnaBridge 189:f392fc9709a3 39 uint32_t R11_reg;
AnnaBridge 189:f392fc9709a3 40 uint32_t R12_reg;
AnnaBridge 189:f392fc9709a3 41 uint32_t SP_reg;
AnnaBridge 189:f392fc9709a3 42 uint32_t LR_reg;
AnnaBridge 189:f392fc9709a3 43 uint32_t PC_reg;
AnnaBridge 189:f392fc9709a3 44 uint32_t xPSR;
AnnaBridge 189:f392fc9709a3 45 uint32_t PSP;
AnnaBridge 189:f392fc9709a3 46 uint32_t MSP;
AnnaBridge 189:f392fc9709a3 47 uint32_t EXC_RETURN;
AnnaBridge 189:f392fc9709a3 48 uint32_t CONTROL;
AnnaBridge 189:f392fc9709a3 49 } mbed_fault_context_t;
AnnaBridge 189:f392fc9709a3 50
AnnaBridge 189:f392fc9709a3 51 //Fault type definitions
AnnaBridge 189:f392fc9709a3 52 //WARNING: DO NOT CHANGE THESE VALUES WITHOUT MAKING CORRESPONDING CHANGES in except.S files.
AnnaBridge 189:f392fc9709a3 53 #define HARD_FAULT_EXCEPTION (0x10) //Keep some gap between values for any future insertion/expansion
AnnaBridge 189:f392fc9709a3 54 #define MEMMANAGE_FAULT_EXCEPTION (0x20)
AnnaBridge 189:f392fc9709a3 55 #define BUS_FAULT_EXCEPTION (0x30)
AnnaBridge 189:f392fc9709a3 56 #define USAGE_FAULT_EXCEPTION (0x40)
AnnaBridge 189:f392fc9709a3 57
AnnaBridge 189:f392fc9709a3 58 //This is a handler function called from Fault handler to print the error information out.
AnnaBridge 189:f392fc9709a3 59 //This runs in fault context and uses special functions(defined in mbed_fault_handler.c) to print the information without using C-lib support.
AnnaBridge 189:f392fc9709a3 60 void mbed_fault_handler (uint32_t fault_type, void *mbed_fault_context_in);
AnnaBridge 189:f392fc9709a3 61
AnnaBridge 189:f392fc9709a3 62 /**
AnnaBridge 189:f392fc9709a3 63 * Call this function to retrieve the fault context after a fatal exception which triggered a system reboot. The function retrieves the fault context stored in crash-report ram area which is preserved over reboot.
AnnaBridge 189:f392fc9709a3 64 * @param fault_context Pointer to mbed_fault_context_t struct allocated by the caller. This is the mbed_fault_context_t info captured as part of the fatal exception which triggered the reboot.
AnnaBridge 189:f392fc9709a3 65 * @return 0 or MBED_SUCCESS on success.
AnnaBridge 189:f392fc9709a3 66 * MBED_ERROR_INVALID_ARGUMENT in case of invalid error_info pointer
AnnaBridge 189:f392fc9709a3 67 * MBED_ERROR_ITEM_NOT_FOUND if no reboot context is currently captured by teh system
AnnaBridge 189:f392fc9709a3 68 *
AnnaBridge 189:f392fc9709a3 69 */
AnnaBridge 189:f392fc9709a3 70 mbed_error_status_t mbed_get_reboot_fault_context (mbed_fault_context_t *fault_context);
AnnaBridge 189:f392fc9709a3 71
AnnaBridge 189:f392fc9709a3 72 #ifdef __cplusplus
AnnaBridge 189:f392fc9709a3 73 }
AnnaBridge 189:f392fc9709a3 74 #endif
AnnaBridge 189:f392fc9709a3 75
AnnaBridge 189:f392fc9709a3 76 #endif