mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-12-27 18:25:05 +00:00
Rather than just reset the board, report assertion failures to aid debugging. To enable this, use CONFIG_ASSERT_HELP. BUG=chrome-os-partner:10149 TEST=manual Enable the option for snow, add a failing ASSERT() to the rw command and see the a nice message is printed now. ASSERTION FAILURE 'address' in command_read_word() at common/memory_commands.c:00000037 Change-Id: Ice59434c5daf610832dd0e1fcfa5630dc847bb67 Signed-off-by: Simon Glass <sjg@chromium.org> Reviewed-on: https://gerrit.chromium.org/gerrit/25411
82 lines
2.4 KiB
C
82 lines
2.4 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 __PANIC_H
|
|
#include <stdarg.h>
|
|
|
|
/**
|
|
* Write a character to the panic reporting device
|
|
*
|
|
* This function will not return until the character has left the UART
|
|
* data register. Any previously queued UART traffic is displayed first.
|
|
*
|
|
* @param ch Character to write
|
|
*/
|
|
void panic_putc(int ch);
|
|
|
|
/**
|
|
* 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 vprintf() for use in panic situations
|
|
*
|
|
* We only support %s and %nx where n is the number of hex digits to display.
|
|
* Currently we don't even support %d, and it is aimed at small code size.
|
|
*
|
|
* TODO(sjg@chromium.org): Really what we need is a vsnprintf() that is
|
|
* shared between the console UART and panic (and is also available as an
|
|
* snprintf()). The only downside is that we would then require a large
|
|
* printf() implementation to be always present, whereas presumably now we
|
|
* can turn it off.
|
|
*
|
|
* @param format printf-style format string
|
|
* @param args List of arguments to process
|
|
*/
|
|
void panic_vprintf(const char *format, va_list args);
|
|
|
|
/**
|
|
* 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, ...);
|
|
|
|
|
|
/**
|
|
* 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
|
|
*/
|
|
void panic_assert_fail(const char *msg, const char *func, const char *fname,
|
|
int linenum);
|
|
|
|
/**
|
|
* Report a panic to the panic reporting device
|
|
*
|
|
* This is exported only to permit use from assembler.
|
|
*
|
|
* @param msg Panic message
|
|
* @param lregs Registers from the exception: psp, ipsr, lr, r4-r11
|
|
*/
|
|
void report_panic(const char *msg, uint32_t *lregs);
|
|
|
|
#endif
|