From 9a09a8c2948a5ecc16660226304bfe4a5d90bbb2 Mon Sep 17 00:00:00 2001
From: wdfk-prog <1425075683@qq.com>
Date: Mon, 2 Mar 2026 11:17:19 +0800
Subject: [PATCH] docs(core): Add help description for
 RT_USING_THREADSAFE_PRINTF

---
 src/Kconfig | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/Kconfig b/src/Kconfig
index d278169da0e..ee1ecbd1269 100644
--- a/src/Kconfig
+++ b/src/Kconfig
@@ -413,8 +413,15 @@ config RT_USING_INTERRUPT_INFO
         Add name and counter information for interrupt trace.
 
 config RT_USING_THREADSAFE_PRINTF
-    bool "Enable thread safe kernel print service"
+    bool "Enable thread-safe kernel print service (not recommended for hard real-time)"
     default y if RT_USING_SMP && RT_USING_SMART
+    help
+        Note : this option may increase worst-case
+        interrupt/scheduling latency, because console output is protected in
+        a non-preemptible section and device write can be relatively slow.
+        If strict real-time response is required, avoid frequent synchronous
+        kprintf output in time-critical paths, or prefer asynchronous logging
+        (for example ULog async mode).
 
 config RT_USING_CONSOLE
     bool "Using console for rt_kprintf"