blob: 9aef15b514fe802e12e6923082fe02c56f3b3247 [file] [log] [blame]
Harry Liebel57bb6582013-12-19 13:30:58 +00001/*
Alexei Fedorov813c9f92020-03-03 13:31:58 +00002 * Copyright (c) 2013-2020, ARM Limited and Contributors. All rights reserved.
Harry Liebel57bb6582013-12-19 13:30:58 +00003 *
dp-armfa3cf0b2017-05-03 09:38:09 +01004 * SPDX-License-Identifier: BSD-3-Clause
Harry Liebel57bb6582013-12-19 13:30:58 +00005 */
6
Antonio Nino Diazc0c8eb62018-08-15 17:02:28 +01007#ifndef DEBUG_H
8#define DEBUG_H
Harry Liebel57bb6582013-12-19 13:30:58 +00009
Antonio Nino Diaze0f90632018-12-14 00:18:21 +000010#include <lib/utils_def.h>
Antonio Nino Diaz14fabd02018-08-28 11:44:44 +010011
Sandrine Bailleuxbf789e72018-06-20 14:50:48 +020012/*
13 * The log output macros print output to the console. These macros produce
Dan Handleycba2c502014-08-08 14:36:42 +010014 * compiled log output only if the LOG_LEVEL defined in the makefile (or the
15 * make command line) is greater or equal than the level required for that
16 * type of log output.
Sandrine Bailleuxbf789e72018-06-20 14:50:48 +020017 *
Dan Handleycba2c502014-08-08 14:36:42 +010018 * The format expected is the same as for printf(). For example:
19 * INFO("Info %s.\n", "message") -> INFO: Info message.
20 * WARN("Warning %s.\n", "message") -> WARNING: Warning message.
Harry Liebel57bb6582013-12-19 13:30:58 +000021 */
Dan Handleycba2c502014-08-08 14:36:42 +010022
Antonio Nino Diaz14fabd02018-08-28 11:44:44 +010023#define LOG_LEVEL_NONE U(0)
24#define LOG_LEVEL_ERROR U(10)
25#define LOG_LEVEL_NOTICE U(20)
26#define LOG_LEVEL_WARNING U(30)
27#define LOG_LEVEL_INFO U(40)
28#define LOG_LEVEL_VERBOSE U(50)
Dan Handleycba2c502014-08-08 14:36:42 +010029
Julius Werner53456fc2019-07-09 13:49:11 -070030#ifndef __ASSEMBLER__
Antonio Nino Diaze0f90632018-12-14 00:18:21 +000031
Antonio Nino Diaz4b32e622018-08-16 16:52:57 +010032#include <cdefs.h>
Soby Mathewf583a062017-09-04 11:45:52 +010033#include <stdarg.h>
Antonio Nino Diazd5876462018-08-23 15:13:58 +010034#include <stdbool.h>
Soby Mathew6b28c572016-03-21 10:36:47 +000035#include <stdio.h>
Dan Handleycba2c502014-08-08 14:36:42 +010036
Antonio Nino Diaze0f90632018-12-14 00:18:21 +000037#include <drivers/console.h>
38
Soby Mathewaaf15f52017-09-04 11:49:29 +010039/*
40 * Define Log Markers corresponding to each log level which will
41 * be embedded in the format string and is expected by tf_log() to determine
42 * the log level.
43 */
44#define LOG_MARKER_ERROR "\xa" /* 10 */
45#define LOG_MARKER_NOTICE "\x14" /* 20 */
46#define LOG_MARKER_WARNING "\x1e" /* 30 */
47#define LOG_MARKER_INFO "\x28" /* 40 */
48#define LOG_MARKER_VERBOSE "\x32" /* 50 */
49
Sandrine Bailleuxbf789e72018-06-20 14:50:48 +020050/*
51 * If the log output is too low then this macro is used in place of tf_log()
52 * below. The intent is to get the compiler to evaluate the function call for
53 * type checking and format specifier correctness but let it optimize it out.
54 */
55#define no_tf_log(fmt, ...) \
56 do { \
Antonio Nino Diaz14fabd02018-08-28 11:44:44 +010057 if (false) { \
Sandrine Bailleuxbf789e72018-06-20 14:50:48 +020058 tf_log(fmt, ##__VA_ARGS__); \
59 } \
Antonio Nino Diaz14fabd02018-08-28 11:44:44 +010060 } while (false)
Sandrine Bailleuxbf789e72018-06-20 14:50:48 +020061
Dan Handleycba2c502014-08-08 14:36:42 +010062#if LOG_LEVEL >= LOG_LEVEL_ERROR
Soby Mathewaaf15f52017-09-04 11:49:29 +010063# define ERROR(...) tf_log(LOG_MARKER_ERROR __VA_ARGS__)
Dan Handleycba2c502014-08-08 14:36:42 +010064#else
Sandrine Bailleuxbf789e72018-06-20 14:50:48 +020065# define ERROR(...) no_tf_log(LOG_MARKER_ERROR __VA_ARGS__)
Dan Handleycba2c502014-08-08 14:36:42 +010066#endif
67
John Tsichritzise75b9a52018-09-07 14:42:09 +010068#if LOG_LEVEL >= LOG_LEVEL_NOTICE
69# define NOTICE(...) tf_log(LOG_MARKER_NOTICE __VA_ARGS__)
70#else
71# define NOTICE(...) no_tf_log(LOG_MARKER_NOTICE __VA_ARGS__)
72#endif
73
Dan Handleycba2c502014-08-08 14:36:42 +010074#if LOG_LEVEL >= LOG_LEVEL_WARNING
Soby Mathewaaf15f52017-09-04 11:49:29 +010075# define WARN(...) tf_log(LOG_MARKER_WARNING __VA_ARGS__)
Dan Handleycba2c502014-08-08 14:36:42 +010076#else
Sandrine Bailleuxbf789e72018-06-20 14:50:48 +020077# define WARN(...) no_tf_log(LOG_MARKER_WARNING __VA_ARGS__)
Dan Handleycba2c502014-08-08 14:36:42 +010078#endif
79
80#if LOG_LEVEL >= LOG_LEVEL_INFO
Soby Mathewaaf15f52017-09-04 11:49:29 +010081# define INFO(...) tf_log(LOG_MARKER_INFO __VA_ARGS__)
Dan Handleycba2c502014-08-08 14:36:42 +010082#else
Sandrine Bailleuxbf789e72018-06-20 14:50:48 +020083# define INFO(...) no_tf_log(LOG_MARKER_INFO __VA_ARGS__)
Dan Handleycba2c502014-08-08 14:36:42 +010084#endif
85
86#if LOG_LEVEL >= LOG_LEVEL_VERBOSE
Soby Mathewaaf15f52017-09-04 11:49:29 +010087# define VERBOSE(...) tf_log(LOG_MARKER_VERBOSE __VA_ARGS__)
Harry Liebel57bb6582013-12-19 13:30:58 +000088#else
Sandrine Bailleuxbf789e72018-06-20 14:50:48 +020089# define VERBOSE(...) no_tf_log(LOG_MARKER_VERBOSE __VA_ARGS__)
Harry Liebel57bb6582013-12-19 13:30:58 +000090#endif
91
Douglas Raillard77414632018-08-21 12:54:45 +010092#if ENABLE_BACKTRACE
93void backtrace(const char *cookie);
Alexei Fedorov813c9f92020-03-03 13:31:58 +000094const char *get_el_str(unsigned int el);
Douglas Raillard77414632018-08-21 12:54:45 +010095#else
96#define backtrace(x)
97#endif
98
Dan Handleya17fefa2014-05-14 12:38:32 +010099void __dead2 do_panic(void);
Antonio Nino Diazd5876462018-08-23 15:13:58 +0100100
101#define panic() \
102 do { \
103 backtrace(__func__); \
104 (void)console_flush(); \
105 do_panic(); \
106 } while (false)
Soby Mathew5e5c2072014-04-07 15:28:55 +0100107
Douglas Raillard306593d2017-02-24 18:14:15 +0000108/* Function called when stack protection check code detects a corrupted stack */
109void __dead2 __stack_chk_fail(void);
110
Soby Mathewaaf15f52017-09-04 11:49:29 +0100111void tf_log(const char *fmt, ...) __printflike(1, 2);
Soby Mathewaaf15f52017-09-04 11:49:29 +0100112void tf_log_set_max_level(unsigned int log_level);
Soby Mathewafe7e2f2014-06-12 17:23:58 +0100113
Julius Werner53456fc2019-07-09 13:49:11 -0700114#endif /* __ASSEMBLER__ */
Antonio Nino Diazc0c8eb62018-08-15 17:02:28 +0100115#endif /* DEBUG_H */