feature: utest: add standardized utest documentation to messagequeue_tc

Signed-off-by: Ze-Hou <yingkezhou@qq.com>
This commit is contained in:
Ze-Hou
2025-11-19 10:38:26 +08:00
committed by R b b666
parent c745319c56
commit 75f1d8d0dc

View File

@@ -8,6 +8,44 @@
* 2021-08-28 Sherman the first version
* 2023-09-15 xqyjlj change stack size in cpu64
* fix in smp
* 2025-11-17 Ze-Hou add standardized utest documentation block
*/
/**
* Test Case Name: Kernel Core Message Queue Test
*
* Test Objectives:
* - Validate the RT-Thread kernel message queue (rt_messagequeue) functionality
* - Test static and dynamic message queue creation, initialization, sending,
* receiving, urgent send, priority send, reset, detach, and delete APIs
*
* Test Scenarios:
* - Initialize a static message queue and verify correct setup
* - Create a dynamic message queue and verify allocation
* - Send messages to the queue until full, test blocking and non-blocking send,
* urgent send, and priority send (if enabled)
* - Receive messages from the queue, verify order and data integrity, including
* priority receive (if enabled)
* - Reset the message queue and verify it is empty
* - Detach and delete message queues, ensuring resources are released
* - Use multiple threads to simulate concurrent send/receive operations
*
* Verification Metrics:
* - All uassert assertions pass without failure
* - Message queues are created, initialized, detached, and deleted successfully
* - Messages are sent and received in correct order and with correct data
* - Blocking and non-blocking operations behave as expected
* - Urgent and priority send/receive functions work correctly (if enabled)
*
* Dependencies:
* - Enable message queue priority (RT-Thread Kernel -> Inter-Thread communication
* -> Enable message queue priority)
* - Enable Message Queue Test (RT-Thread Utestcases -> Kernel Core -> Message Queue Test)
* - Test on any RT-Thread supported platform (e.g., qemu-virt64-riscv)
*
* Expected Results:
* - After executing this test in msh, the expected output should be:
* "[ PASSED ] [ result ] testcase (core.messagequeue)"
*/
#include <rtthread.h>