ra8_exception.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>

typedef struct {
  uint32_t r0;   
  uint32_t r1;   
  uint32_t r2;   
  uint32_t r3;   
  uint32_t r12;  
  uint32_t lr;   
  uint32_t pc;   
  uint32_t xpsr; 
} ra8_exception_frame_t;

typedef struct {
  uint32_t cfsr;  
  uint32_t hfsr;  
  uint32_t dfsr;  
  uint32_t bfar;  
  uint32_t mmfar; 
  uint32_t afsr;  
  uint32_t sfsr;  
  uint32_t sfar;  
} ra8_exception_diagnostics_t;

typedef enum : uint32_t {
  k_ra8_exc_magic_valid = 0xFA17DEADUL, 
} ra8_exception_magic_t;

typedef struct {
  uint32_t                    magic;      
  uint32_t                    exc_number; 
  ra8_exception_frame_t       frame;      
  ra8_exception_diagnostics_t diag;       
  uintptr_t                   frame_ptr;  
  uint32_t                    nmisr;      
} ra8_exception_last_t;

extern volatile ra8_exception_last_t g_ra8_exception_last;

typedef void (*ra8_exception_persist_fn)(const volatile ra8_exception_last_t* decoded);

void ra8_exception_set_persist_hook(ra8_exception_persist_fn hook);

void ra8_exception_capture_diagnostics(ra8_exception_diagnostics_t* out);

[[noreturn]] void ra8_exception_report(const ra8_exception_frame_t* frame, uint32_t exc_number);

[[noreturn]] void ra8_exception_report_nmi(const ra8_exception_frame_t* frame, uint32_t nmisr);
 
#ifdef __cplusplus
}
#endif