mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-12-28 02:35:28 +00:00
baf3bac6d8
Currently, when an assertion fails, the error message is like: ASSERTION FAILURE '1 + 1 == 3' in command_apreset() at common/chipset.c:24 To save flash space, let's add an option to remove the failed expression and function name. The error message becomes: ASSERTION FAILURE at common/chipset.c:24 BUG=chrome-os-partner:32203 TEST=make buildall TEST=Add an assertion and triggers it. Check error message. BRANCH=None Change-Id: Ie323d5b43cbff2cd8f6cd5bb46c1f34ecd16bd5e Signed-off-by: Vic Yang <victoryang@chromium.org> Reviewed-on: https://chromium-review.googlesource.com/219670 Reviewed-by: Randall Spangler <rspangler@chromium.org>
139 lines
3.7 KiB
C
139 lines
3.7 KiB
C
/* Copyright (c) 2012 The Chromium OS Authors. All rights reserved.
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*
|
|
* Panic handling, including displaying a message on the panic reporting
|
|
* device, which is currently the UART.
|
|
*/
|
|
|
|
#ifndef __CROS_EC_PANIC_H
|
|
#define __CROS_EC_PANIC_H
|
|
|
|
#include <stdarg.h>
|
|
|
|
/* ARM Cortex-Mx registers saved on panic */
|
|
struct cortex_panic_data {
|
|
uint32_t regs[12]; /* psp, ipsr, msp, r4-r11, lr(=exc_return).
|
|
* In version 1, that was uint32_t regs[11] =
|
|
* psp, ipsr, lr, r4-r11
|
|
*/
|
|
uint32_t frame[8]; /* r0-r3, r12, lr, pc, xPSR */
|
|
|
|
uint32_t mmfs;
|
|
uint32_t bfar;
|
|
uint32_t mfar;
|
|
uint32_t shcsr;
|
|
uint32_t hfsr;
|
|
uint32_t dfsr;
|
|
};
|
|
|
|
/* Data saved across reboots */
|
|
struct panic_data {
|
|
uint8_t arch; /* Architecture (PANIC_ARCH_*) */
|
|
uint8_t struct_version; /* Structure version (currently 2) */
|
|
uint8_t flags; /* Flags (PANIC_DATA_FLAG_*) */
|
|
uint8_t reserved; /* Reserved; set 0 */
|
|
|
|
/* core specific panic data */
|
|
union {
|
|
struct cortex_panic_data cm; /* Cortex-Mx registers */
|
|
};
|
|
|
|
/*
|
|
* These fields go at the END of the struct so we can find it at the
|
|
* end of memory.
|
|
*/
|
|
uint32_t struct_size; /* Size of this struct */
|
|
uint32_t magic; /* PANIC_SAVE_MAGIC if valid */
|
|
};
|
|
|
|
#define PANIC_DATA_MAGIC 0x21636e50 /* "Pnc!" */
|
|
#define PANIC_ARCH_CORTEX_M 1 /* Cortex-M architecture */
|
|
|
|
/*
|
|
* Panic data goes at the end of RAM. This is safe because we don't context
|
|
* switch away from the panic handler before rebooting, and stacks and data
|
|
* start at the beginning of RAM.
|
|
*/
|
|
#define PANIC_DATA_PTR ((struct panic_data *)\
|
|
(CONFIG_RAM_BASE + CONFIG_RAM_SIZE - sizeof(struct panic_data)))
|
|
|
|
/* Flags for panic_data.flags */
|
|
/* panic_data.frame is valid */
|
|
#define PANIC_DATA_FLAG_FRAME_VALID (1 << 0)
|
|
/* Already printed at console */
|
|
#define PANIC_DATA_FLAG_OLD_CONSOLE (1 << 1)
|
|
/* Already returned via host command */
|
|
#define PANIC_DATA_FLAG_OLD_HOSTCMD (1 << 2)
|
|
|
|
/**
|
|
* Write a string to the panic reporting device
|
|
*
|
|
* This function will not return until the string has left the UART
|
|
* data register. Any previously queued UART traffic is displayed first.
|
|
*
|
|
* @param ch Character to write
|
|
*/
|
|
void panic_puts(const char *s);
|
|
|
|
/**
|
|
* Very basic printf() for use in panic situations
|
|
*
|
|
* See panic_vprintf() for full details
|
|
*
|
|
* @param format printf-style format string
|
|
* @param ... Arguments to process
|
|
*/
|
|
void panic_printf(const char *format, ...);
|
|
|
|
/*
|
|
* Print saved panic information
|
|
*
|
|
* @param pdata pointer to saved panic data
|
|
*/
|
|
void panic_data_print(const struct panic_data *pdata);
|
|
|
|
/**
|
|
* Report an assertion failure and reset
|
|
*
|
|
* @param msg Assertion expression or other message
|
|
* @param func Function name where assertion happened
|
|
* @param fname File name where assertion happened
|
|
* @param linenum Line number where assertion happened
|
|
*/
|
|
#ifdef CONFIG_DEBUG_ASSERT_BRIEF
|
|
void panic_assert_fail(const char *fname, int linenum);
|
|
#else
|
|
void panic_assert_fail(const char *msg, const char *func, const char *fname,
|
|
int linenum);
|
|
#endif
|
|
|
|
/**
|
|
* Display a custom panic message and reset
|
|
*
|
|
* @param msg Panic message
|
|
*/
|
|
void panic(const char *msg);
|
|
|
|
/**
|
|
* Display a default message and reset
|
|
*/
|
|
void panic_reboot(void);
|
|
|
|
/**
|
|
* Enable/disable bus fault handler
|
|
*
|
|
* @param ignored Non-zero if ignoring bus fault
|
|
*/
|
|
void ignore_bus_fault(int ignored);
|
|
|
|
/**
|
|
* Return a pointer to the saved data from a previous panic.
|
|
*
|
|
* @param pointer to the panic data, or NULL if none available (for example,
|
|
* the last reboot was not caused by a panic).
|
|
*/
|
|
struct panic_data *panic_get_data(void);
|
|
|
|
#endif /* __CROS_EC_PANIC_H */
|