[add][thread]Add api:rt_thread_suspend_any allow suspend other threads.

Author: Rbb666

include/rtthread.h

@@ -175,6 +175,7 @@ rt_err_t rt_thread_mdelay(rt_int32_t ms);
 rt_err_t rt_thread_control(rt_thread_t thread, int cmd, void *arg);
 rt_err_t rt_thread_suspend(rt_thread_t thread);
 rt_err_t rt_thread_suspend_with_flag(rt_thread_t thread, int suspend_flag);
+rt_err_t rt_thread_suspend_any(rt_thread_t thread, int suspend_flag);
 rt_err_t rt_thread_resume(rt_thread_t thread);
 #ifdef RT_USING_SMART
 rt_err_t rt_thread_wakeup(rt_thread_t thread);

src/thread.c

@@ -35,6 +35,7 @@
  * 2023-09-15     xqyjlj       perf rt_hw_interrupt_disable/enable
  * 2023-12-10     xqyjlj       fix thread_exit/detach/delete
  *                             fix rt_thread_delay
+ * 2025-09-01     Rbb666       add api:rt_thread_suspend_any.
  */
 
 #include <rthw.h>
@@ -883,12 +884,9 @@ static void _thread_set_suspend_state(struct rt_thread *thread, int suspend_flag
 /**
  * @brief   This function will suspend the specified thread and change it to suspend state.
  *
- * @note    This function ONLY can suspend current thread itself.
- *              rt_thread_suspend(rt_thread_self());
- *
- *          Do not use the rt_thread_suspend to suspend other threads. You have no way of knowing what code a
- *          thread is executing when you suspend it. If you suspend a thread while sharing a resouce with
- *          other threads and occupying this resouce, starvation can occur very easily.
+ * @note    This function can suspend any thread including other threads.
+ *          WARNING: Suspending other threads can be dangerous and may cause deadlocks
+ *          if the target thread holds important resources.
  *
  * @param   thread the thread to be suspended.
  * @param   susp_list the list thread enqueued to. RT_NULL if no list.
@@ -902,19 +900,23 @@ static void _thread_set_suspend_state(struct rt_thread *thread, int suspend_flag
  *          the first-in-first-out principle, and you clearly understand that all threads involved in
  *          this semaphore will become non-real-time threads.
  * @param   suspend_flag status flag of the thread to be suspended.
+ * @param   force_suspend if RT_TRUE, allows suspending other threads
  *
  * @return  Return the operation status. If the return value is RT_EOK, the function is successfully executed.
  *          If the return value is any other values, it means this operation failed.
  */
-rt_err_t rt_thread_suspend_to_list(rt_thread_t thread, rt_list_t *susp_list, int ipc_flags, int suspend_flag)
+static rt_err_t rt_thread_suspend_to_list_ex(rt_thread_t thread, rt_list_t *susp_list, int ipc_flags, int suspend_flag, rt_bool_t force_suspend)
 {
     rt_base_t stat;
     rt_sched_lock_level_t slvl;
 
     /* parameter check */
     RT_ASSERT(thread != RT_NULL);
     RT_ASSERT(rt_object_get_type((rt_object_t)thread) == RT_Object_Class_Thread);
-    RT_ASSERT(thread == rt_thread_self());
+
+    /* only allow suspending other threads if explicitly requested */
+    if (!force_suspend)
+        RT_ASSERT(thread == rt_thread_self());
 
     LOG_D("thread suspend:  %s", thread->parent.name);
 
@@ -928,12 +930,6 @@ rt_err_t rt_thread_suspend_to_list(rt_thread_t thread, rt_list_t *susp_list, int
         return -RT_ERROR;
     }
 
-    if (stat == RT_THREAD_RUNNING)
-    {
-        /* not suspend running status thread on other core */
-        RT_ASSERT(thread == rt_thread_self());
-    }
-
 #ifdef RT_USING_SMART
     if (thread->lwp)
     {
@@ -982,6 +978,30 @@ rt_err_t rt_thread_suspend_to_list(rt_thread_t thread, rt_list_t *susp_list, int
     RT_OBJECT_HOOK_CALL(rt_thread_suspend_hook, (thread));
     return RT_EOK;
 }
+RTM_EXPORT(rt_thread_suspend_to_list_ex);
+
+/**
+ * @brief   This function will suspend any thread including other threads.
+ *
+ * @warning This function can be dangerous! Only use it if you understand the risks.
+ *          Suspending threads that hold mutexes or other resources can cause deadlocks.
+ *
+ * @param   thread the thread to be suspended.
+ * @param   suspend_flag status flag of the thread to be suspended.
+ *
+ * @return  Return the operation status. If the return value is RT_EOK, the function is successfully executed.
+ *          If the return value is any other values, it means this operation failed.
+ */
+rt_err_t rt_thread_suspend_any(rt_thread_t thread, int suspend_flag)
+{
+    return rt_thread_suspend_to_list_ex(thread, RT_NULL, 0, suspend_flag, RT_TRUE);
+}
+RTM_EXPORT(rt_thread_suspend_any);
+
+rt_err_t rt_thread_suspend_to_list(rt_thread_t thread, rt_list_t *susp_list, int ipc_flags, int suspend_flag)
+{
+    return rt_thread_suspend_to_list_ex(thread, susp_list, ipc_flags, suspend_flag, RT_FALSE);
+}
 RTM_EXPORT(rt_thread_suspend_to_list);
 
 /**