utest: move lwp testcases to components/lwp

Signed-off-by: CYFS <[email protected]>

6 files changed, 1 insertions, 484 deletions

diff --git a/examples/utest/README.md b/examples/utest/README.md
index 04c3f910f1..f21884b5b7 100644
--- a/examples/utest/README.md
+++ b/examples/utest/README.md
@@ -9,13 +9,12 @@
 | 目录      | 用途                                                         |
 | --------- | ------------------------------------------------------------ |
 | configs   | 配置文件集合（每一个目录代表一种功能集合，如：kernel,net等） |
-| testcases | 测试用例源代码                                               |
 
 ## 如何贡献
 
 ### 1. 编写测试用例
 
-参考已有的测试用例在 [examples\utest\testcases](./testcases) 目录下添加自己的测试用例。测试用例的编写方法参考文档中心[《utest 测试框架》章节](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/utest/utest)。
+参考已有的测试用例，在对应模块目录下添加 `utest` 目录并维护自己的测试用例，例如串口测试用例位于 `components/drivers/serial/utest`。测试用例的编写方法参考文档中心[《utest 测试框架》章节](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/utest/utest)。
 
 ### 2. 本地测试
 
diff --git a/examples/utest/testcases/SConscript b/examples/utest/testcases/SConscript
deleted file mode 100644
index 4c815c49b8..0000000000
--- a/examples/utest/testcases/SConscript
+++ /dev/null
@@ -1,15 +0,0 @@
-# RT-Thread building script for bridge
-
-import os
-from building import *
-
-cwd = GetCurrentDir()
-objs = []
-list = os.listdir(cwd)
-
-for d in list:
-    path = os.path.join(cwd, d)
-    if os.path.isfile(os.path.join(path, 'SConscript')):
-        objs = objs + SConscript(os.path.join(d, 'SConscript'))
-
-Return('objs')
diff --git a/examples/utest/testcases/lwp/SConscript b/examples/utest/testcases/lwp/SConscript
deleted file mode 100644
index 68fe5bea41..0000000000
--- a/examples/utest/testcases/lwp/SConscript
+++ /dev/null
@@ -1,13 +0,0 @@
-Import('rtconfig')
-from building import *
-
-cwd     = GetCurrentDir()
-src     = []
-CPPPATH = [cwd]
-
-if GetDepend(['UTEST_LWP_TC', 'RT_USING_SMART']):
-    src += ['condvar_timedwait_tc.c', 'condvar_broadcast_tc.c', 'condvar_signal_tc.c']
-
-group = DefineGroup('utestcases', src, depend = ['RT_USING_UTESTCASES'], CPPPATH = CPPPATH)
-
-Return('group')
diff --git a/examples/utest/testcases/lwp/condvar_broadcast_tc.c b/examples/utest/testcases/lwp/condvar_broadcast_tc.c
deleted file mode 100644
index 234ae697a1..0000000000
--- a/examples/utest/testcases/lwp/condvar_broadcast_tc.c
+++ /dev/null
@@ -1,190 +0,0 @@
-/*
- * Copyright (c) 2006-2023, RT-Thread Development Team
- *
- * SPDX-License-Identifier: Apache-2.0
- *
- * Change Logs:
- * Date           Author       Notes
- * 2023-11-20     Shell        add test suites
- * 2026-03-19     cl2t         Add standardized utest documentation block
- */
-
-/**
- * Test Case Name: Condition Variable Broadcast Test
- *
- * Test Objectives:
- * - Verify that rt_condvar_broadcast() correctly wakes up all threads
- *   waiting on a condition variable.
- * - Test core APIs: rt_condvar_broadcast(), rt_condvar_timedwait(),
- *   rt_mutex_take(), rt_mutex_release(), rt_mutex_get_owner().
- *
- * Test Scenarios:
- * - Creates 8 worker threads, each acquiring a mutex and then waiting on
- *   a condition variable via rt_condvar_timedwait().
- * - The main thread calls rt_condvar_broadcast() to wake all waiters.
- * - Each woken thread verifies it re-acquired the mutex, increments a
- *   counter, and releases the mutex.
- * - The main thread verifies all 8 threads were successfully woken.
- *
- * Verification Metrics:
- * - All waiting threads must be woken after broadcast (waken_num == THREAD_NUM).
- * - Each woken thread must hold the mutex (verified via rt_mutex_get_owner()).
- * - rt_condvar_timedwait() must return 0 on successful wake.
- * - Mutex release must succeed for each woken thread.
- *
- * Dependencies:
- * - Software configuration: RT_USING_SMART must be enabled.
- * - Environmental assumptions: The platform must support multi-threading
- *   with at least 8 concurrent threads.
- *
- * Expected Results:
- * - Final output: "[ PASSED ] [ result ] testcase (testcases.ipc.condvar.broadcast)"
- * - No assertion failures during test execution.
- */
-
-#include "common.h"
-#include "rtconfig.h"
-#include "utest_assert.h"
-
-#include <rtdevice.h>
-#include <rtdef.h>
-
-static struct rt_mutex _local_mtx;
-static struct rt_condvar _local_cv;
-#define THREAD_NUM 8
-#define STACK_SIZE (0x2000)
-
-static volatile int start_num;
-static volatile int waken_num;
-
-static void thr_func(void *arg)
-{
-    int rc;
-    rt_mutex_t mutex = &_local_mtx;
-    rt_condvar_t cond = &_local_cv;
-    rt_mutex_take(mutex, RT_WAITING_FOREVER);
-
-    start_num++;
-    rc = rt_condvar_timedwait(cond, mutex, RT_KILLABLE, RT_WAITING_FOREVER);
-    if (rc != 0)
-    {
-        LOG_E("cond_wait returned %d\n", rc);
-        uassert_false(1);
-        return;
-    }
-
-    if (rt_mutex_get_owner(mutex) != rt_thread_self())
-    {
-        LOG_E("Should not be able to lock the mutex again");
-        uassert_false(1);
-        return;
-    }
-    else
-    {
-        uassert_true(1);
-    }
-    LOG_I("Thread was wakened and acquired the mutex again");
-    waken_num++;
-
-    if (rt_mutex_release(mutex) != 0)
-    {
-        LOG_E("Failed to release the mutex");
-        uassert_false(1);
-        return;
-    }
-    else
-    {
-        uassert_true(1);
-    }
-
-    return ;
-}
-
-static void *stack_addr[THREAD_NUM];
-
-static void condvar_broadcast_tc(void)
-{
-    rt_mutex_t mutex = &_local_mtx;
-    rt_condvar_t cond = &_local_cv;
-    struct rt_thread thread[THREAD_NUM];
-
-    for (size_t i = 0; i < THREAD_NUM; i++)
-    {
-        if (rt_thread_init(&thread[i], "utest", thr_func, RT_NULL,
-                           stack_addr[i], STACK_SIZE, 25, 100) != 0)
-        {
-            LOG_E("Fail to create thread[%d]\n", i);
-            return;
-        }
-        rt_thread_startup(&thread[i]);
-    }
-
-    while (start_num < THREAD_NUM)
-        rt_thread_mdelay(1);
-
-    rt_mutex_take(mutex, RT_WAITING_FOREVER);
-    if (rt_condvar_broadcast(cond))
-    {
-        uassert_false(1);
-        return ;
-    }
-    rt_mutex_release(mutex);
-
-    rt_thread_mdelay(1);
-
-    if (waken_num < THREAD_NUM)
-    {
-        LOG_E("[Main thread] Not all waiters were wakened\n");
-        uassert_false(1);
-        return ;
-    }
-    else
-    {
-        utest_int_equal(waken_num, THREAD_NUM);
-    }
-    LOG_I("[Main thread] all waiters were wakened\n");
-
-    return;
-}
-
-static rt_err_t utest_tc_init(void)
-{
-    start_num = 0;
-    waken_num = 0;
-    if (rt_mutex_init(&_local_mtx, "utest", RT_IPC_FLAG_PRIO) != 0)
-    {
-        perror("pthread_mutex_init() error");
-        uassert_false(1);
-        return -1;
-    }
-
-    rt_condvar_init(&_local_cv, NULL);
-
-    for (size_t i = 0; i < THREAD_NUM; i++)
-    {
-        stack_addr[i] =
-            rt_pages_alloc_ext(rt_page_bits(STACK_SIZE), PAGE_ANY_AVAILABLE);
-        utest_int_not_equal(stack_addr[i], RT_NULL);
-    }
-    return RT_EOK;
-}
-
-static rt_err_t utest_tc_cleanup(void)
-{
-    rt_mutex_detach(&_local_mtx);
-    rt_condvar_detach(&_local_cv);
-
-    for (size_t i = 0; i < THREAD_NUM; i++)
-    {
-        rt_pages_free(stack_addr[i], rt_page_bits(STACK_SIZE));
-        stack_addr[i] = 0;
-    }
-    return RT_EOK;
-}
-
-static void testcase(void)
-{
-    UTEST_UNIT_RUN(condvar_broadcast_tc);
-}
-UTEST_TC_EXPORT(testcase, "testcases.ipc.condvar.broadcast", utest_tc_init,
-                utest_tc_cleanup, 10);
diff --git a/examples/utest/testcases/lwp/condvar_signal_tc.c b/examples/utest/testcases/lwp/condvar_signal_tc.c
deleted file mode 100644
index 82129560eb..0000000000
--- a/examples/utest/testcases/lwp/condvar_signal_tc.c
+++ /dev/null
@@ -1,156 +0,0 @@
-/*
- * Copyright (c) 2006-2023, RT-Thread Development Team
- *
- * SPDX-License-Identifier: Apache-2.0
- *
- * Change Logs:
- * Date           Author       Notes
- * 2023-11-20     Shell        add test suites
- * 2026-03-19     cl2t         Add standardized utest documentation block
- */
-
-/**
- * Test Case Name: Condition Variable Signal Test
- *
- * Test Objectives:
- * - Verify that rt_condvar_signal() correctly wakes up a single thread
- *   waiting on a condition variable.
- * - Test core APIs: rt_condvar_signal(), rt_condvar_timedwait(),
- *   rt_mutex_take(), rt_mutex_release(), rt_thread_create().
- *
- * Test Scenarios:
- * - The main thread acquires a mutex, creates a waker thread, then waits
- *   on a condition variable with a 100-tick timeout.
- * - The waker thread acquires the mutex and calls rt_condvar_signal() to
- *   wake the main thread.
- * - The main thread verifies it was woken successfully and releases the
- *   mutex.
- *
- * Verification Metrics:
- * - rt_condvar_signal() must return 0 on success.
- * - rt_condvar_timedwait() must return 0 when signaled before timeout.
- * - Timeout (-ETIMEDOUT) or interrupt (-EINTR) are acceptable non-fatal
- *   outcomes.
- * - Mutex acquire and release must succeed without errors.
- *
- * Dependencies:
- * - Software configuration: RT_USING_SMART must be enabled.
- * - Environmental assumptions: The platform must support multi-threading.
- *
- * Expected Results:
- * - Final output: "[ PASSED ] [ result ] testcase (testcases.ipc.condvar.signal)"
- * - No assertion failures during test execution.
- */
-
-#include "common.h"
-#include "utest_assert.h"
-
-#include <rtdevice.h>
-#include <rtdef.h>
-#define STACK_SIZE (0x2000)
-
-static struct rt_mutex _local_mtx;
-static struct rt_condvar _local_cv;
-
-static void waker_thr(void *param)
-{
-    int err;
-    rt_mutex_t mutex = &_local_mtx;
-    rt_condvar_t cond = &_local_cv;
-    rt_mutex_take(mutex, RT_WAITING_FOREVER);
-    err = rt_condvar_signal(cond);
-
-    if (err != 0)
-    {
-        LOG_E("errno=%d, ret=%d\n", errno, err);
-        LOG_E("rt_condvar_signal() error");
-        uassert_false(1);
-    }
-    else
-    {
-        uassert_false(0);
-    }
-    rt_mutex_release(mutex);
-
-    return;
-}
-
-static void condvar_signal_tc(void)
-{
-    rt_thread_t waker;
-    rt_mutex_t mutex = &_local_mtx;
-    rt_condvar_t cond = &_local_cv;
-    int err;
-
-    waker = rt_thread_create("waker", waker_thr, 0, STACK_SIZE, 25, 50);
-    uassert_not_null(waker);
-
-    if (rt_mutex_take(mutex, RT_WAITING_FOREVER) != 0)
-    {
-        LOG_E("pthread_mutex_lock() error");
-        uassert_false(1);
-        return;
-    }
-    else
-    {
-        uassert_false(0);
-    }
-
-    rt_thread_startup(waker);
-
-    err = rt_condvar_timedwait(cond, mutex, RT_KILLABLE, 100);
-    if (err != 0)
-    {
-        if (err == -EINTR || err == -ETIMEDOUT)
-        {
-            puts("wait timed out");
-            uassert_false(0);
-        }
-        else
-        {
-            LOG_E("errno=%d, ret=%d\n", errno, err);
-            LOG_E("pthread_cond_timedwait() error");
-            uassert_false(1);
-        }
-    }
-
-    err = rt_mutex_release(mutex);
-    if (err != 0)
-    {
-        LOG_E("errno=%d, ret=%d\n", errno, err);
-        LOG_E("rt_mutex_release() error");
-        uassert_false(1);
-    }
-    else
-    {
-        uassert_false(0);
-    }
-
-    return ;
-}
-
-static rt_err_t utest_tc_init(void)
-{
-    if (rt_mutex_init(&_local_mtx, "utest", RT_IPC_FLAG_PRIO) != 0)
-    {
-        perror("pthread_mutex_init() error");
-        uassert_false(1);
-        return -1;
-    }
-
-    rt_condvar_init(&_local_cv, NULL);
-    return RT_EOK;
-}
-
-static rt_err_t utest_tc_cleanup(void)
-{
-    rt_mutex_detach(&_local_mtx);
-    rt_condvar_detach(&_local_cv);
-    return RT_EOK;
-}
-
-static void testcase(void)
-{
-    UTEST_UNIT_RUN(condvar_signal_tc);
-}
-UTEST_TC_EXPORT(testcase, "testcases.ipc.condvar.signal", utest_tc_init, utest_tc_cleanup, 10);
diff --git a/examples/utest/testcases/lwp/condvar_timedwait_tc.c b/examples/utest/testcases/lwp/condvar_timedwait_tc.c
deleted file mode 100644
index 43cfceb695..0000000000
--- a/examples/utest/testcases/lwp/condvar_timedwait_tc.c
+++ /dev/null
@@ -1,108 +0,0 @@
-/*
- * Copyright (c) 2006-2023, RT-Thread Development Team
- *
- * SPDX-License-Identifier: Apache-2.0
- *
- * Change Logs:
- * Date           Author       Notes
- * 2023-11-20     Shell        add test suites
- * 2026-03-19     cl2t         Add standardized utest documentation block
- */
-
-/**
- * Test Case Name: Condition Variable Timed Wait Test
- *
- * Test Objectives:
- * - Verify that rt_condvar_timedwait() correctly times out when no signal
- *   is received within the specified timeout period.
- * - Test core APIs: rt_condvar_timedwait(), rt_mutex_take(),
- *   rt_mutex_init(), rt_condvar_init().
- *
- * Test Scenarios:
- * - The main thread acquires a mutex and calls rt_condvar_timedwait()
- *   with a 100-tick timeout.
- * - Since no other thread signals the condition variable, the call is
- *   expected to time out with -ETIMEDOUT or be interrupted with -EINTR.
- *
- * Verification Metrics:
- * - rt_condvar_timedwait() must return -ETIMEDOUT or -EINTR when no
- *   signal is received.
- * - Any other non-zero return value indicates a test failure.
- * - Mutex initialization and acquisition must succeed.
- *
- * Dependencies:
- * - Software configuration: RT_USING_SMART must be enabled.
- * - Environmental assumptions: The platform must support condition
- *   variables and mutexes.
- *
- * Expected Results:
- * - Final output: "[ PASSED ] [ result ] testcase (testcases.ipc.condvar.timedwait)"
- * - No assertion failures during test execution.
- */
-
-#include "common.h"
-#include "utest_assert.h"
-
-#include <rtdevice.h>
-#include <rtdef.h>
-
-static struct rt_mutex _local_mtx;
-static struct rt_condvar _local_cv;
-
-static void condvar_timedwait_tc(void)
-{
-    rt_mutex_t mutex = &_local_mtx;
-    rt_condvar_t cond = &_local_cv;
-    int err;
-
-    if (rt_mutex_take(mutex, RT_WAITING_FOREVER) != 0)
-    {
-        LOG_E("pthread_mutex_lock() error");
-        uassert_false(1);
-        return;
-    }
-
-    err = rt_condvar_timedwait(cond, mutex, RT_KILLABLE, 100);
-    if (err != 0)
-    {
-        if (err == -EINTR || err == -ETIMEDOUT)
-        {
-            puts("wait timed out");
-            uassert_false(0);
-        }
-        else
-        {
-            LOG_E("errno=%d, ret=%d\n", errno, err);
-            LOG_E("pthread_cond_timedwait() error");
-            uassert_false(1);
-        }
-    }
-
-    return ;
-}
-
-static rt_err_t utest_tc_init(void)
-{
-    if (rt_mutex_init(&_local_mtx, "utest", RT_IPC_FLAG_PRIO) != 0)
-    {
-        perror("pthread_mutex_init() error");
-        uassert_false(1);
-        return -1;
-    }
-
-    rt_condvar_init(&_local_cv, NULL);
-    return RT_EOK;
-}
-
-static rt_err_t utest_tc_cleanup(void)
-{
-    rt_mutex_detach(&_local_mtx);
-    rt_condvar_detach(&_local_cv);
-    return RT_EOK;
-}
-
-static void testcase(void)
-{
-    UTEST_UNIT_RUN(condvar_timedwait_tc);
-}
-UTEST_TC_EXPORT(testcase, "testcases.ipc.condvar.timedwait", utest_tc_init, utest_tc_cleanup, 10);