summaryrefslogtreecommitdiff
path: root/examples
diff options
context:
space:
mode:
authorYuqiang Wang <[email protected]>2025-07-30 10:58:49 +0800
committerGitHub <[email protected]>2025-07-30 10:58:49 +0800
commit62f3fb4ce5504d0cf870cd17ba78011c6252a637 (patch)
tree5d92750f2207abb48ad4dff230c2cfc9f64e22c9 /examples
parentdc894172295ce8f1c532a57cdb320511cafdfc33 (diff)
fix(kernel)/improve(utest):fix the legacy issue related to the length of the object name version #10537
Diffstat (limited to 'examples')
-rw-r--r--examples/utest/testcases/kernel/Kconfig10
-rw-r--r--examples/utest/testcases/kernel/object_tc.c309
2 files changed, 273 insertions, 46 deletions
diff --git a/examples/utest/testcases/kernel/Kconfig b/examples/utest/testcases/kernel/Kconfig
index ec1054fae8..278de61a29 100644
--- a/examples/utest/testcases/kernel/Kconfig
+++ b/examples/utest/testcases/kernel/Kconfig
@@ -1,9 +1,5 @@
menu "Kernel Testcase"
-config UTEST_OBJECT_TC
- bool "object test"
- default y
-
config UTEST_MEMHEAP_TC
bool "memheap stability test"
default y
@@ -14,6 +10,12 @@ config UTEST_SMALL_MEM_TC
default y
depends on RT_USING_SMALL_MEM
+config UTEST_OBJECT_TC
+ select RT_USING_DEVICE
+ select RT_USING_SEMAPHORE
+ bool "object test"
+ default n
+
config UTEST_SLAB_TC
bool "slab test"
default n
diff --git a/examples/utest/testcases/kernel/object_tc.c b/examples/utest/testcases/kernel/object_tc.c
index 156fd8e730..2afeda3492 100644
--- a/examples/utest/testcases/kernel/object_tc.c
+++ b/examples/utest/testcases/kernel/object_tc.c
@@ -13,75 +13,293 @@
#include <string.h>
/**
- * @brief Test case for verifying object name handling functionality
+ * @brief Comprehensive test suite for RT-Thread object system
*
* @note This test suite validates:
- * 1. Proper truncation of long object names
- * 2. Correct NULL name handling
- * 3. Exact length name preservation
- * 4. Both static and dynamic object initialization
- * 5. Memory safety and boundary conditions
+ * 1. Object name handling (truncation, NULL, exact length)
+ * 2. Static and dynamic object initialization
+ * 3. Object finding functionality (rt_object_find, rt_thread_find, rt_device_find)
+ * 4. Object information and enumeration
+ * 5. Type checking and system object detection
+ * 6. Memory safety and boundary conditions
*/
-static void test_object_name_handling(void)
+/* Define TEST_RT_NAME_MAX for testing purposes */
+#define TEST_RT_NAME_MAX RT_NAME_MAX
+
+/* Global counter for unique object names */
+static rt_uint32_t name_counter = 0;
+
+/* Generate unique name to avoid conflicts, respecting TEST_RT_NAME_MAX */
+static rt_err_t generate_unique_name(char *buf, rt_size_t size, const char *prefix)
{
- struct rt_object static_obj1;
- struct rt_object static_obj2;
- struct rt_object static_obj3;
- rt_object_t dyn_obj = RT_NULL;
- char test_name[RT_NAME_MAX + 5];
+ if (!buf || !prefix || size < TEST_RT_NAME_MAX)
+ return -RT_EINVAL;
- for (int i = 0; i < sizeof(test_name) - 1; i++)
+ for (int i = 0; i < 1000; i++) /* Limit attempts to prevent infinite loop */
{
- test_name[i] = 'A' + (i % 26);
+ rt_snprintf(buf, size, "%s%d", prefix, name_counter++);
+ rt_size_t len = rt_strlen(buf);
+ if (len >= TEST_RT_NAME_MAX)
+ {
+ buf[TEST_RT_NAME_MAX - 1] = '\0';
+ len = TEST_RT_NAME_MAX - 1;
+ }
+
+ /* Check if name (or truncated name) is unique */
+ if (rt_object_find(buf, RT_Object_Class_Unknown) == RT_NULL &&
+ rt_thread_find(buf) == RT_NULL &&
+ rt_device_find(buf) == RT_NULL)
+ {
+ return RT_EOK;
+ }
}
- test_name[sizeof(test_name) - 1] = '\0';
+ return -RT_ENOMEM;
+}
- /* Test 1: Static Object Initialization - Extra Long Name */
+static void test_object_name_handling(void)
+{
+ struct rt_object static_obj1, static_obj2, static_obj3;
+ rt_object_t dyn_obj = RT_NULL;
+ char test_name[TEST_RT_NAME_MAX];
+ char unique_name[TEST_RT_NAME_MAX];
+
+ /* Prepare a test name within TEST_RT_NAME_MAX */
+ rt_memset(test_name, 'A', TEST_RT_NAME_MAX - 1);
+ test_name[TEST_RT_NAME_MAX - 1] = '\0';
+
+ /* Test 1: Static Object with Name Within TEST_RT_NAME_MAX */
+ uassert_true(generate_unique_name(unique_name, TEST_RT_NAME_MAX, "long") == RT_EOK);
rt_object_init(&static_obj1, RT_Object_Class_Thread, test_name);
- uassert_true(rt_strlen(static_obj1.name) <= RT_NAME_MAX - 1);
- uassert_true(static_obj1.name[RT_NAME_MAX - 1] == '\0');
+ uassert_true(rt_strlen(static_obj1.name) <= TEST_RT_NAME_MAX - 1);
+ uassert_true(static_obj1.name[TEST_RT_NAME_MAX - 1] == '\0');
+ uassert_true(rt_strncmp(static_obj1.name, test_name, TEST_RT_NAME_MAX - 1) == 0);
+ uassert_true(rt_object_is_systemobject(&static_obj1));
+ rt_object_detach(&static_obj1);
- /* Test 2: Dynamic Object Allocation */
+ /* Test 2: Dynamic Object with Name Within TEST_RT_NAME_MAX */
+ uassert_true(generate_unique_name(unique_name, TEST_RT_NAME_MAX, "dyn") == RT_EOK);
dyn_obj = rt_object_allocate(RT_Object_Class_Thread, test_name);
uassert_not_null(dyn_obj);
- if (dyn_obj)
- {
- uassert_true(rt_strlen(dyn_obj->name) <= RT_NAME_MAX - 1);
- uassert_true(dyn_obj->name[RT_NAME_MAX - 1] == '\0');
- rt_object_delete(dyn_obj);
- dyn_obj = RT_NULL;
- }
+ uassert_true(rt_strlen(dyn_obj->name) <= TEST_RT_NAME_MAX - 1);
+ uassert_true(dyn_obj->name[TEST_RT_NAME_MAX - 1] == '\0');
+ uassert_true(rt_strncmp(dyn_obj->name, test_name, TEST_RT_NAME_MAX - 1) == 0);
+ uassert_false(rt_object_is_systemobject(dyn_obj));
+ rt_object_delete(dyn_obj);
- /* Test 3: NULL Name Handling - Using New Static Object */
+ /* Test 3: NULL Name Handling */
+ uassert_true(generate_unique_name(unique_name, TEST_RT_NAME_MAX, "null") == RT_EOK);
rt_object_init(&static_obj2, RT_Object_Class_Thread, NULL);
uassert_true(static_obj2.name[0] == '\0');
+ rt_object_detach(&static_obj2);
- /* Test 4: Dynamic Object with NULL Name */
+ uassert_true(generate_unique_name(unique_name, TEST_RT_NAME_MAX, "dynull") == RT_EOK);
dyn_obj = rt_object_allocate(RT_Object_Class_Thread, NULL);
uassert_not_null(dyn_obj);
- if (dyn_obj)
+ uassert_true(dyn_obj->name[0] == '\0');
+ rt_object_delete(dyn_obj);
+
+ /* Test 4: Exact Length Name */
+ char exact_name[TEST_RT_NAME_MAX];
+ rt_memset(exact_name, 'B', TEST_RT_NAME_MAX - 1);
+ exact_name[TEST_RT_NAME_MAX - 1] = '\0';
+ uassert_true(generate_unique_name(unique_name, TEST_RT_NAME_MAX, "exact") == RT_EOK);
+ rt_object_init(&static_obj3, RT_Object_Class_Thread, exact_name);
+ uassert_str_equal(static_obj3.name, exact_name);
+ rt_object_detach(&static_obj3);
+}
+
+static void test_object_find_operations(void)
+{
+ rt_object_t found;
+ rt_thread_t found_thread;
+ rt_device_t found_device;
+ char name[TEST_RT_NAME_MAX];
+ rt_err_t ret;
+
+ /* Scenario 1: Object Name Within TEST_RT_NAME_MAX */
+ /* Test 1.1: Find static thread object with rt_object_find */
+ struct rt_object static_obj;
+ uassert_true(generate_unique_name(name, TEST_RT_NAME_MAX, "sobj") == RT_EOK);
+ rt_object_init(&static_obj, RT_Object_Class_Thread, name);
+ found = rt_object_find(name, RT_Object_Class_Thread);
+ uassert_not_null(found);
+ uassert_ptr_equal(found, &static_obj);
+ uassert_str_equal(found->name, name);
+ rt_object_detach(&static_obj);
+
+ /* Test 1.2: Find thread object with rt_thread_find */
+ uassert_true(generate_unique_name(name, TEST_RT_NAME_MAX, "thr") == RT_EOK);
+ rt_thread_t thread = rt_thread_create(name, RT_NULL, RT_NULL, 1024, 20, 10);
+ uassert_not_null(thread);
+ found_thread = rt_thread_find(name);
+ uassert_not_null(found_thread);
+ uassert_ptr_equal(found_thread, thread);
+ uassert_str_equal(found_thread->parent.name, name);
+ rt_thread_delete(thread);
+
+#ifdef RT_USING_DEVICE
+ /* Test 1.3: Find device object with rt_device_find */
+ struct rt_device device;
+ uassert_true(generate_unique_name(name, TEST_RT_NAME_MAX, "dev") == RT_EOK);
+ ret = rt_device_register(&device, name, RT_DEVICE_FLAG_RDONLY);
+ uassert_int_equal(ret, RT_EOK);
+ found_device = rt_device_find(name);
+ uassert_not_null(found_device);
+ uassert_ptr_equal(found_device, &device);
+ uassert_str_equal(found_device->parent.name, name);
+ rt_device_unregister(&device);
+#endif
+
+ /* Test 2: Same Prefix Within TEST_RT_NAME_MAX */
+#ifdef RT_USING_DEVICE
+ struct rt_device dev1, dev2;
+ char name1[TEST_RT_NAME_MAX] = "norflash1";
+ char name2[TEST_RT_NAME_MAX] = "norflash2";
+ ret = rt_device_register(&dev1, name1, RT_DEVICE_FLAG_RDONLY);
+ uassert_int_equal(ret, RT_EOK);
+ ret = rt_device_register(&dev2, name2, RT_DEVICE_FLAG_RDONLY);
+ uassert_int_equal(ret, RT_EOK); /* Expect success if RT-Thread allows distinct names */
+ found_device = rt_device_find(name1);
+ uassert_not_null(found_device);
+ uassert_ptr_equal(found_device, &dev1);
+ uassert_str_equal(found_device->parent.name, name1);
+ found_device = rt_device_find(name2);
+ uassert_not_null(found_device);
+ uassert_ptr_equal(found_device, &dev2);
+ uassert_str_equal(found_device->parent.name, name2);
+ rt_device_unregister(&dev1);
+ rt_device_unregister(&dev2);
+#endif
+
+ /* Test 3: Find non-existent object */
+ const char *nonexist_name = "nonexist";
+ uassert_true(rt_strlen(nonexist_name) <= TEST_RT_NAME_MAX - 1);
+ found = rt_object_find(nonexist_name, RT_Object_Class_Thread);
+ uassert_null(found);
+
+ /* Test 4: Find with NULL name */
+ found = rt_object_find(NULL, RT_Object_Class_Thread);
+ uassert_null(found);
+ found_thread = rt_thread_find(NULL);
+ uassert_null(found_thread);
+
+#ifdef RT_USING_DEVICE
+ found_device = rt_device_find(NULL);
+ uassert_null(found_device);
+#endif
+}
+
+static void test_object_info_enumeration(void)
+{
+ struct rt_object static_objs[3];
+ rt_object_t dyn_objs[2] = {RT_NULL, RT_NULL};
+ char names[5][TEST_RT_NAME_MAX];
+
+ /* Generate unique names */
+ for (int i = 0; i < 5; i++)
{
- uassert_true(dyn_obj->name[0] == '\0');
- rt_object_delete(dyn_obj);
- dyn_obj = RT_NULL;
+ uassert_true(generate_unique_name(names[i], TEST_RT_NAME_MAX, "enum") == RT_EOK);
}
- /* Test 5: Fixed-Length Name - Using Third Static Object */
- char exact_name[RT_NAME_MAX];
- rt_memset(exact_name, 'B', RT_NAME_MAX - 1);
- exact_name[RT_NAME_MAX - 1] = '\0';
+ /* Create test objects */
+ for (int i = 0; i < 3; i++)
+ {
+ rt_object_init(&static_objs[i], RT_Object_Class_Thread, names[i]);
+ }
+ for (int i = 0; i < 2; i++)
+ {
+ dyn_objs[i] = rt_object_allocate(RT_Object_Class_Thread, names[i + 3]);
+ uassert_not_null(dyn_objs[i]);
+ }
- rt_object_init(&static_obj3, RT_Object_Class_Thread, exact_name);
- uassert_str_equal(static_obj3.name, exact_name);
+ /* Test 1: Get object information */
+ struct rt_object_information *info = rt_object_get_information(RT_Object_Class_Thread);
+ uassert_not_null(info);
+ uassert_int_equal(info->type, RT_Object_Class_Thread);
- rt_object_detach(&static_obj1);
- rt_object_detach(&static_obj2);
- rt_object_detach(&static_obj3);
+ /* Test 2: Get object count */
+ int count = rt_object_get_length(RT_Object_Class_Thread);
+ uassert_true(count >= 5);
+
+ /* Test 3: Get object pointers with sufficient buffer */
+ rt_object_t *objects = (rt_object_t *)rt_malloc((count + 2) * sizeof(rt_object_t));
+ uassert_not_null(objects);
+ int ret = rt_object_get_pointers(RT_Object_Class_Thread, objects, count + 2);
+ uassert_int_equal(ret, count);
+ int found_count = 0;
+ for (int i = 0; i < ret; i++)
+ {
+ for (int j = 0; j < 3; j++)
+ if (objects[i] == &static_objs[j]) found_count++;
+ for (int j = 0; j < 2; j++)
+ if (objects[i] == dyn_objs[j]) found_count++;
+ }
+ uassert_int_equal(found_count, 5);
+ rt_free(objects);
+
+ /* Test 4: Get object pointers with small buffer */
+ rt_object_t one_object[1];
+ ret = rt_object_get_pointers(RT_Object_Class_Thread, one_object, 1);
+ uassert_true(ret <= 1);
+
+ /* Test 5: Empty container (Semaphore) */
+#ifdef RT_USING_SEMAPHORE
+ int empty_count = rt_object_get_length(RT_Object_Class_Semaphore);
+ uassert_true(empty_count >= 0);
+#endif
+
+ /* Cleanup */
+ for (int i = 0; i < 3; i++)
+ rt_object_detach(&static_objs[i]);
+ for (int i = 0; i < 2; i++)
+ if (dyn_objs[i]) rt_object_delete(dyn_objs[i]);
+}
+
+static void test_object_type_handling(void)
+{
+ struct rt_object obj;
+ char name[TEST_RT_NAME_MAX];
+ uassert_true(generate_unique_name(name, TEST_RT_NAME_MAX, "typ") == RT_EOK);
+ rt_object_init(&obj, RT_Object_Class_Thread, name);
+
+ /* Test 1: Get object type */
+ uassert_int_equal(rt_object_get_type(&obj), RT_Object_Class_Thread);
+
+ /* Test 2: Check system object */
+ uassert_true(rt_object_is_systemobject(&obj));
+
+ /* Test 3: Get name with sufficient buffer */
+ char name_buf[TEST_RT_NAME_MAX];
+ rt_err_t ret = rt_object_get_name(&obj, name_buf, sizeof(name_buf));
+ uassert_int_equal(ret, RT_EOK);
+ uassert_str_equal(name_buf, name);
+
+ /* Test 4: Get name with small buffer */
+ char small_buf[4] = {0};
+ ret = rt_object_get_name(&obj, small_buf, sizeof(small_buf));
+ uassert_int_equal(ret, RT_EOK);
+ uassert_true(rt_strncmp(small_buf, name, sizeof(small_buf) - 1) == 0);
+ uassert_true(small_buf[sizeof(small_buf) - 1] == '\0');
+
+ /* Test 5: Get name with invalid parameters */
+ ret = rt_object_get_name(RT_NULL, name_buf, sizeof(name_buf));
+ uassert_int_equal(ret, -RT_EINVAL);
+ ret = rt_object_get_name(&obj, NULL, sizeof(name_buf));
+ uassert_int_equal(ret, -RT_EINVAL);
+ ret = rt_object_get_name(&obj, name_buf, 0);
+ uassert_int_equal(ret, -RT_EINVAL);
+
+ rt_object_detach(&obj);
}
static rt_err_t testcase_init(void)
{
+ if (!rt_scheduler_is_available())
+ {
+ return -RT_ERROR;
+ }
+ name_counter = 0;
return RT_EOK;
}
@@ -92,6 +310,13 @@ static rt_err_t testcase_cleanup(void)
static void test_object_suite(void)
{
+#ifdef RT_NAME_MAX < 10
+ rt_kprintf("Error: Please increase \'RT_NAME_MAX\' to be greater than 10.\n");
+ return;
+#endif
UTEST_UNIT_RUN(test_object_name_handling);
+ UTEST_UNIT_RUN(test_object_find_operations);
+ UTEST_UNIT_RUN(test_object_info_enumeration);
+ UTEST_UNIT_RUN(test_object_type_handling);
}
-UTEST_TC_EXPORT(test_object_suite, "testcases.kernel.object_test", testcase_init, testcase_cleanup, 10);
+UTEST_TC_EXPORT(test_object_suite, "testcases.kernel.object_test", testcase_init, testcase_cleanup, 20); \ No newline at end of file