blob: 908e8df0d6f9e3f319e29817e43b6d1f72a1008f [file] [log] [blame]
/*
* Copyright (c) 2018 Intel Corporation.
*
* SPDX-License-Identifier: Apache-2.0
*/
#include <zephyr.h>
#include <tc_util.h>
#include <ztest.h>
#include <kernel.h>
#ifdef CONFIG_SMP
#error Cannot test MP API if SMP is using the CPUs
#endif
BUILD_ASSERT(CONFIG_MP_NUM_CPUS > 1);
#define CPU1_STACK_SIZE 1024
K_THREAD_STACK_DEFINE(cpu1_stack, CPU1_STACK_SIZE);
int cpu_arg;
volatile int cpu_running;
/**
* @brief Tests for multi processing
*
* @defgroup kernel_mp_tests MP Tests
*
* @ingroup all_tests
*
* @{
* @}
*/
FUNC_NORETURN void cpu1_fn(void *arg)
{
zassert_true(arg == &cpu_arg && *(int *)arg == 12345, "wrong arg");
cpu_running = 1;
while (1) {
}
}
/**
* @brief Test to verify CPU start
*
* @ingroup kernel_mp_tests
*
* @details
* Test Objective:
* - To verify kernel architecture layer shall provide a means to start non-boot
* CPUs on SMP systems.
* The way we verify it is to call it by give it parameters especially the
* target executing function, etc. Then check if the function is running or
* not.
*
* Testing techniques:
* - Interface testing, function and block box testing,
* dynamic analysis and testing
*
* Prerequisite Conditions:
* - CONFIG_MP_NUM_CPUS > 1
*
* Input Specifications:
* - CPU ID: the cpu want to start
* - Stack structure
* - Stack size
* - Target executing function
* - An argument that pass to the function
*
* Test Procedure:
* -# In main thread, given and set a global variable cpu_arg to 12345.
* -# Call arch_start_cpu() with parameters
* -# Enter a while loop and wait for cpu_running equals to 1.
* -# In target function, check if the address is &cpu_arg and its content
* equal to 12345.
* -# Set the global flag variable cpu_running to 1.
* -# In main thread, check if the cpu_running equals to 1.
*
* Expected Test Result:
* - The given function execute cpu is running and .
*
* Pass/Fail Criteria:
* - Successful if the check of step 4, 6 are all pass.
* - Failure if one of the check of step 4, 6 is failed.
*
* Assumptions and Constraints:
* - This test using for the platform that support MP or SMP, in our current
* scenario which own over two CPUs.
*
* @see arch_start_cpu()
*/
void test_mp_start(void)
{
cpu_arg = 12345;
arch_start_cpu(1, cpu1_stack, CPU1_STACK_SIZE, cpu1_fn, &cpu_arg);
while (!cpu_running) {
}
zassert_true(cpu_running, "cpu1 didn't start");
}
void test_main(void)
{
ztest_test_suite(multiprocessing,
ztest_unit_test(test_mp_start));
ztest_run_test_suite(multiprocessing);
}