File syn_fault.h

FileList > src > syntropic > system > syn_fault.h

Go to the source code of this file

CPU Hard Fault / Post-Mortem Diagnostic log collector.

• #include "../common/syn_defs.h"
• #include "syn_errlog.h"
• #include <stdbool.h>
• #include <stdint.h>

Classes

Type	Name
struct	SYN_FaultContext Register context dumped on CPU hard faults (ARM Cortex-M style).
struct	SYN_FaultDump Fault dump stored in noinit RAM across resets.

Public Functions

Type	Name
void	syn_fault_capture (const SYN_FaultContext * ctx) Capture a CPU fault register state.
bool	syn_fault_check_and_log (SYN_ErrLog * errlog) Checks if a crash occurred in a previous boot, logs it, and clears the signature.

Macros

Type	Name
define	SYN_FAULT_SIGNATURE 0xFA17C0DE

Public Functions Documentation

function syn_fault_capture

Capture a CPU fault register state.

void syn_fault_capture (
    const SYN_FaultContext * ctx
) 

Saves register dump to uninitialized RAM and sets the signature. Safe to call from a hard fault handler (no heap, no locks).

Parameters:

• ctx Pointer to the register context to save (NULL is ignored).

---

function syn_fault_check_and_log

Checks if a crash occurred in a previous boot, logs it, and clears the signature.

bool syn_fault_check_and_log (
    SYN_ErrLog * errlog
) 

Parameters:

• errlog Pointer to the active error log.

Returns:

true if a fault was checked, logged, and cleared.

---

Macro Definition Documentation

define SYN_FAULT_SIGNATURE

#define SYN_FAULT_SIGNATURE `0xFA17C0DE`

Magic value indicating a valid fault dump

---

---

The documentation for this class was generated from the following file src/syntropic/system/syn_fault.h