summaryrefslogtreecommitdiff
path: root/src/utest/smp/smp_thread_preemption_tc.c
blob: b8493d9be20aa89d4b3673172fd7566c88f1cfc0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
/*
 * Copyright (c) 2006-2024, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2024-08-10     RV           the first version
 */

#include <rtthread.h>
#include "utest.h"

/**
 * @brief   Thread Preemption Test with Different Priorities.
 *
 * @note    Create multiple threads, low-priority threads run first,
 *          high-priority threads preempt low-priority threads, and
 *          print the current status of each core in the thread's entry function.
 *
 * Test Case Name: [smp_thread_preemptions]
 *
 * Test Objectives:
 * - Test the thread preemption logic under the SMP architecture
 *
 * Test Scenarios:
 * - A high-priority thread thigh and a low-priority thread tlow are created. Since tlow is created
 * - prior to thigh, it prints the thread list information first and then waits for the finish_flag
 * - bit. Once thigh becomes ready, it preempts tlow, prints the thread list, and then sets the
 * - finish_flag bit. After that, tlow exits the busy-wait loop.
 *
 * Verification Metrics:
 * - First, the message "Low priority thread is running" will be displayed, followed immediately by
 * - a thread_list information list. Subsequently, the message "High priority thread is running" will
 * - appear, and in the thread_list that follows, the tlow thread can be observed in the ready state.
 *
 * Dependencies:
 * - Enable RT_USING_SMP, set RT_THREAD_PRIORITY_MAX = 256.
 *
 * Expected Results:
 * - You will see the message "[ PASSED ] [ result ] testcase (core.smp_thread_preemptions)", and observe
 * - the tlow thread in the ready state in the thread_list printed by the thigh thread.
 */

#define THREAD_PRIORITY_HIGH 21
#define THREAD_PRIORITY_LOW  30
#define THREAD_STACK_SIZE UTEST_THR_STACK_SIZE

static rt_thread_t   threads[2];
static volatile rt_uint8_t    finish_flag = 0;
static struct rt_spinlock lock;

/* High Priority Thread */
static void thread_high_entry(void *parameter)
{
    uassert_true(1);
    rt_spin_lock(&lock);
    rt_kprintf("High priority thread is running\n");
    extern long list_thread(void);
    list_thread();
    rt_spin_unlock(&lock);
    finish_flag = 1;
}

/* Low Priority Thread */
static void thread_low_entry(void *parameter)
{
    uassert_true(1);
    rt_spin_lock(&lock);
    rt_kprintf("Low priority thread is running\n");
    extern long list_thread(void);
    list_thread();
    rt_spin_unlock(&lock);
    while (!finish_flag);
}

static void thread_preemptions_tc(void)
{
    /* Creating low-priority thread */
    threads[0] = rt_thread_create("tlow", thread_low_entry, RT_NULL, THREAD_STACK_SIZE, THREAD_PRIORITY_LOW, 10);
    if (threads[0]  != RT_NULL)
    {
        uassert_true(1);
        rt_thread_startup(threads[0] );
    }

    rt_thread_delay(5);
    /* Creating high-priority thread */
    threads[1]  = rt_thread_create("thigh", thread_high_entry, RT_NULL, THREAD_STACK_SIZE, THREAD_PRIORITY_HIGH, 10);
    if (threads[1] != RT_NULL)
    {
        uassert_true(1);
        rt_thread_startup(threads[1]);
    }
    rt_thread_delay(50);
}

static rt_err_t utest_tc_init(void)
{
    rt_spin_lock_init(&lock);
    finish_flag = 0;
    return RT_EOK;
}

static rt_err_t utest_tc_cleanup(void)
{
    return RT_EOK;
}

static void testcase(void)
{
    UTEST_UNIT_RUN(thread_preemptions_tc);
}
UTEST_TC_EXPORT(testcase, "core.smp_thread_preemptions", utest_tc_init, utest_tc_cleanup, 10);