ove_arm_backtrace.h

Go to the documentation of this file.

/*
 * Copyright (C) 2026 Kamil Lulko <kamil.lulko@gmail.com>
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * This file is part of oveRTOS.
 */
 
#ifndef OVE_ARM_BACKTRACE_H
#define OVE_ARM_BACKTRACE_H
 
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
/*
 * Cortex-M basic exception frame layout (word indices from PSP at
 * exception entry). Declared here so profiler backends can read the
 * stacked PC/LR directly without redefining the enum.
 */
enum {
    OVE_ARM_EXC_R0 = 0,
    OVE_ARM_EXC_R1 = 1,
    OVE_ARM_EXC_R2 = 2,
    OVE_ARM_EXC_R3 = 3,
    OVE_ARM_EXC_R12 = 4,
    OVE_ARM_EXC_LR = 5,
    OVE_ARM_EXC_PC = 6,
    OVE_ARM_EXC_XPSR = 7,
};
 
int ove_arm_backtrace_lr_is_post_bl(uintptr_t lr_clean, uintptr_t text_lo, uintptr_t text_hi);
 
int ove_arm_backtrace_walk(uintptr_t psp, uintptr_t text_lo, uintptr_t text_hi, uintptr_t sram_lo,
               uintptr_t sram_hi, uint32_t fill, uintptr_t *out, int max);
 
#ifdef __cplusplus
}
#endif
 
#endif /* OVE_ARM_BACKTRACE_H */