summaryrefslogtreecommitdiff
path: root/include/rtthread.h
diff options
context:
space:
mode:
authorShicheng Chu <[email protected]>2023-07-01 20:41:02 +0800
committerGitHub <[email protected]>2023-07-01 08:41:02 -0400
commit2da019234ebec2cfadc3772e0e216b92da0990a9 (patch)
tree7b99d7345c1db4e06f809258b5491e74df10ace9 /include/rtthread.h
parent2d087c04a4899bc73cae25c5afe0a6d42bb8681b (diff)
[include][dbg]update: delete rtdebug.h (#7759)
Diffstat (limited to 'include/rtthread.h')
-rw-r--r--include/rtthread.h95
1 files changed, 93 insertions, 2 deletions
diff --git a/include/rtthread.h b/include/rtthread.h
index ea3ee6f81a..fdb67a4d06 100644
--- a/include/rtthread.h
+++ b/include/rtthread.h
@@ -18,13 +18,13 @@
* 2021-11-14 Meco Man add rtlegacy.h for compatibility
* 2022-06-04 Meco Man remove strnlen
* 2023-05-20 Bernard add rtatomic.h header file to included files.
+ * 2023-06-30 ChuShicheng Move RT_DEBUG_CONTEXT_CHECK from the rtdebug.h
*/
#ifndef __RT_THREAD_H__
#define __RT_THREAD_H__
#include <rtconfig.h>
-#include <rtdebug.h>
#include <rtdef.h>
#include <rtservice.h>
#include <rtm.h>
@@ -728,8 +728,99 @@ void rt_show_version(void);
#ifdef RT_DEBUG
extern void (*rt_assert_hook)(const char *ex, const char *func, rt_size_t line);
void rt_assert_set_hook(void (*hook)(const char *ex, const char *func, rt_size_t line));
-
void rt_assert_handler(const char *ex, const char *func, rt_size_t line);
+
+/* Turn on this to enable context check */
+#ifndef RT_DEBUG_CONTEXT_CHECK
+#define RT_DEBUG_CONTEXT_CHECK 1
+#endif
+
+#define RT_ASSERT(EX) \
+if (!(EX)) \
+{ \
+ rt_assert_handler(#EX, __FUNCTION__, __LINE__); \
+}
+
+/* Macro to check current context */
+#if RT_DEBUG_CONTEXT_CHECK
+#define RT_DEBUG_NOT_IN_INTERRUPT \
+do \
+{ \
+ rt_base_t level; \
+ level = rt_hw_interrupt_disable(); \
+ if (rt_interrupt_get_nest() != 0) \
+ { \
+ rt_kprintf("Function[%s] shall not be used in ISR\n", __FUNCTION__); \
+ RT_ASSERT(0) \
+ } \
+ rt_hw_interrupt_enable(level); \
+} \
+while (0)
+
+/* "In thread context" means:
+ * 1) the scheduler has been started
+ * 2) not in interrupt context.
+ */
+#define RT_DEBUG_IN_THREAD_CONTEXT \
+do \
+{ \
+ rt_base_t level; \
+ level = rt_hw_interrupt_disable(); \
+ if (rt_thread_self() == RT_NULL) \
+ { \
+ rt_kprintf("Function[%s] shall not be used before scheduler start\n", \
+ __FUNCTION__); \
+ RT_ASSERT(0) \
+ } \
+ RT_DEBUG_NOT_IN_INTERRUPT; \
+ rt_hw_interrupt_enable(level); \
+} \
+while (0)
+
+/* "scheduler available" means:
+ * 1) the scheduler has been started.
+ * 2) not in interrupt context.
+ * 3) scheduler is not locked.
+ * 4) interrupt is not disabled.
+ */
+#define RT_DEBUG_SCHEDULER_AVAILABLE(need_check) \
+do \
+{ \
+ if (need_check) \
+ { \
+ rt_bool_t interrupt_disabled; \
+ rt_base_t level; \
+ interrupt_disabled = rt_hw_interrupt_is_disabled(); \
+ level = rt_hw_interrupt_disable(); \
+ if (rt_critical_level() != 0) \
+ { \
+ rt_kprintf("Function[%s]: scheduler is not available\n", \
+ __FUNCTION__); \
+ RT_ASSERT(0) \
+ } \
+ if (interrupt_disabled == RT_TRUE) \
+ { \
+ rt_kprintf("Function[%s]: interrupt is disabled\n", \
+ __FUNCTION__); \
+ RT_ASSERT(0) \
+ } \
+ RT_DEBUG_IN_THREAD_CONTEXT; \
+ rt_hw_interrupt_enable(level); \
+ } \
+} \
+while (0)
+#else
+#define RT_DEBUG_NOT_IN_INTERRUPT
+#define RT_DEBUG_IN_THREAD_CONTEXT
+#define RT_DEBUG_SCHEDULER_AVAILABLE(need_check)
+#endif
+
+#else /* RT_DEBUG */
+
+#define RT_ASSERT(EX)
+#define RT_DEBUG_NOT_IN_INTERRUPT
+#define RT_DEBUG_IN_THREAD_CONTEXT
+#define RT_DEBUG_SCHEDULER_AVAILABLE(need_check)
#endif /* RT_DEBUG */
#ifdef RT_USING_FINSH