2019-01-25 20:56:10 +08:00
|
|
|
/*
|
|
|
|
* Copyright (c) 2019 Nordic Semiconductor ASA
|
|
|
|
*
|
|
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
|
|
*/
|
|
|
|
|
2022-05-06 17:23:05 +08:00
|
|
|
#include <zephyr/sys/__assert.h>
|
|
|
|
#include <zephyr/sys/printk.h>
|
includes: prefer <zephyr/kernel.h> over <zephyr/zephyr.h>
As of today <zephyr/zephyr.h> is 100% equivalent to <zephyr/kernel.h>.
This patch proposes to then include <zephyr/kernel.h> instead of
<zephyr/zephyr.h> since it is more clear that you are including the
Kernel APIs and (probably) nothing else. <zephyr/zephyr.h> sounds like a
catch-all header that may be confusing. Most applications need to
include a bunch of other things to compile, e.g. driver headers or
subsystem headers like BT, logging, etc.
The idea of a catch-all header in Zephyr is probably not feasible
anyway. Reason is that Zephyr is not a library, like it could be for
example `libpython`. Zephyr provides many utilities nowadays: a kernel,
drivers, subsystems, etc and things will likely grow. A catch-all header
would be massive, difficult to keep up-to-date. It is also likely that
an application will only build a small subset. Note that subsystem-level
headers may use a catch-all approach to make things easier, though.
NOTE: This patch is **NOT** removing the header, just removing its usage
in-tree. I'd advocate for its deprecation (add a #warning on it), but I
understand many people will have concerns.
Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-08-25 15:58:46 +08:00
|
|
|
#include <zephyr/kernel.h>
|
2019-01-25 20:56:10 +08:00
|
|
|
|
2019-02-27 23:26:50 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Assert Action Handler
|
|
|
|
*
|
|
|
|
* This routine implements the action to be taken when an assertion fails.
|
|
|
|
*
|
|
|
|
* System designers may wish to substitute this implementation to take other
|
|
|
|
* actions, such as logging program counter, line number, debug information
|
|
|
|
* to a persistent repository and/or rebooting the system.
|
|
|
|
*
|
|
|
|
* @param N/A
|
|
|
|
*/
|
2019-12-23 20:41:44 +08:00
|
|
|
#ifdef CONFIG_ASSERT_NO_FILE_INFO
|
|
|
|
__weak void assert_post_action(void)
|
|
|
|
#else
|
2019-02-27 23:26:50 +08:00
|
|
|
__weak void assert_post_action(const char *file, unsigned int line)
|
2019-12-23 20:41:44 +08:00
|
|
|
#endif
|
2019-01-25 20:56:10 +08:00
|
|
|
{
|
2019-12-23 20:41:44 +08:00
|
|
|
#ifndef CONFIG_ASSERT_NO_FILE_INFO
|
2019-07-19 05:23:40 +08:00
|
|
|
ARG_UNUSED(file);
|
|
|
|
ARG_UNUSED(line);
|
2019-12-23 20:41:44 +08:00
|
|
|
#endif
|
2019-02-27 23:26:50 +08:00
|
|
|
|
2019-07-19 05:23:40 +08:00
|
|
|
#ifdef CONFIG_USERSPACE
|
|
|
|
/* User threads aren't allowed to induce kernel panics; generate
|
|
|
|
* an oops instead.
|
|
|
|
*/
|
2021-03-28 00:03:18 +08:00
|
|
|
if (k_is_user_context()) {
|
2019-07-19 05:23:40 +08:00
|
|
|
k_oops();
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
k_panic();
|
2019-01-25 20:56:10 +08:00
|
|
|
}
|
2022-03-14 20:56:07 +08:00
|
|
|
|
|
|
|
void assert_print(const char *fmt, ...)
|
|
|
|
{
|
|
|
|
va_list ap;
|
|
|
|
|
|
|
|
va_start(ap, fmt);
|
|
|
|
|
|
|
|
vprintk(fmt, ap);
|
|
|
|
|
|
|
|
va_end(ap);
|
|
|
|
}
|