blob: a1be06fe9d1d66361c3dd6369edaefebc1c34734 (
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
115
116
117
118
119
120
121
122
123
124
125
126
|
/*
* Copyright (c) 2006-2024 RT-Thread Development Team
*
* SPDX-License-Identifier: Apache-2.0
*
* Change Logs:
* Date Author Notes
* 2024/9/12 zhujiale the first version
* 2024/10/28 Shell Added more assertions
* 2025/12/3 ChuanN-sudo add standardized utest documentation block
*/
/**
* Test Case Name: SMP Call Smoke 001 Test
*
* Test Objectives:
* - Validate rt_smp_call_cpu_mask() with SMP_CALL_WAIT_ALL flag for blocking synchronous calls.
* - Verify callback execution on all targeted CPUs.
* - Ensure callback runs in interrupt-disabled context.
* - Test core APIs: rt_smp_call_cpu_mask().
*
* Test Scenarios:
* - Main thread generates random CPU masks and dispatches callbacks to targeted CPUs.
* - Callback function clears corresponding CPU bit from shared mask variable.
* - Blocking call waits for all targeted CPUs to complete execution.
* - Random CPU selection simulates various multi-core scenarios.
*
* Verification Metrics:
* - rt_smp_call_cpu_mask() must block until all targeted CPUs complete callback execution.
* - Shared mask variable must be zero after function returns, confirming all targets executed.
* - Callback must execute in interrupt-disabled context.
* - All available CPUs must be tested throughout the run.
* - Data integrity maintained across CPUs with spinlock protection.
*
* Dependencies:
* - Hardware requirements: QEMU emulator or any multi-core hardware platform that supports RT-Thread.
* - Software configuration:
* - RT_USING_UTEST must be enabled (select "RT-Thread Utestcases" in menuconfig).
* - RT_UTEST_SMP_CALL_FUNC must be enabled(enable via: RT-Thread Utestcases -> Kernel Components -> Drivers -> SMP-Call Test -> SMP-Call Smoke Test).
* - Environmental Assumptions: System scheduler and SMP services working normally.
*
* Expected Results:
* - Final output: "[ PASSED ] [ result ] testcase (components.drivers.smp_call.smoke_001)"
* - No assertions triggered during test execution.
*/
#include <rtdevice.h>
#include <utest.h>
#include <utest_assert.h>
#include <smp_call.h>
#define TEST_COUNT 10000
static int pass_count = 0;
static RT_DEFINE_SPINLOCK(_test_data_lock);
static void _test_smp_cb(void *data)
{
int *maskp;
int oncpu;
if (!rt_hw_interrupt_is_disabled())
{
/* SYNC.004 */
uassert_true(0);
}
rt_spin_lock(&_test_data_lock);
oncpu = rt_hw_cpu_id();
maskp = (int *)data;
*maskp &= ~(1 << oncpu);
rt_spin_unlock(&_test_data_lock);
}
static void _blocking_call(void)
{
volatile int cpu_mask;
rt_ubase_t tested_cpus = 0;
for (int i = 0; i < TEST_COUNT; i++)
{
cpu_mask = rand() % RT_ALL_CPU;
tested_cpus |= cpu_mask;
rt_smp_call_cpu_mask(cpu_mask, _test_smp_cb, (void *)&cpu_mask, SMP_CALL_WAIT_ALL);
if (!cpu_mask)
{
pass_count++;
}
else
{
/* TARG.001, MP.001 */
uassert_true(0);
break;
}
}
LOG_D("pass_count %d", pass_count);
/* TARG.001 */
uassert_true(pass_count == TEST_COUNT);
/* TOP.001, TOP.002 */
uassert_true(tested_cpus == RT_ALL_CPU);
}
static rt_err_t utest_tc_init(void)
{
pass_count = 0;
srand(rt_tick_get());
return RT_EOK;
}
static rt_err_t utest_tc_cleanup(void)
{
return RT_EOK;
}
static void _testcase(void)
{
UTEST_UNIT_RUN(_blocking_call);
}
UTEST_TC_EXPORT(_testcase, "components.drivers.smp_call.smoke_001", utest_tc_init, utest_tc_cleanup, 10);
|