mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_NUCLEO_H743ZI/TOOLCHAIN_ARM_MICRO/mbed_fault_handler.h@172:65be27845400, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 20:53:29 2019 +0000
Revision:
172:65be27845400
mbed library release version 165

Who changed what in which revision?

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