/* * Copyright (c) 2010, Kelvin Lawson. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3. No personal names or organizations' names associated with the * Atomthreads project may be used to endorse or promote products * derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE ATOMTHREADS PROJECT AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ #include "atom.h" #include "atommutex.h" #include "atomtests.h" #include "atomuser.h" /* Test OS objects */ static ATOM_MUTEX mutex1; static ATOM_TCB tcb1, tcb2; static uint8_t test1_thread_stack[TEST_THREAD_STACK_SIZE]; static uint8_t test2_thread_stack[TEST_THREAD_STACK_SIZE]; /* Test result tracking */ static volatile int g_result; /* Forward declarations */ static void test1_thread_func (uint32_t data); static void test2_thread_func (uint32_t data); /** * \b test_start * * Start mutex test. * * This test exercises the mutex creation and deletion APIs, including * waking threads blocking on a mutex if the mutex is deleted. * Deletion wakeups are tested twice: once for a thread which is blocking * with a timeout and once for a thread which is blocking with no timeout. * * @retval Number of failures */ uint32_t test_start (void) { int failures; uint32_t i; /* Default to zero failures */ failures = 0; /* Test creation and deletion of mutexes: good values */ for (i = 0; i < 1000; i++) { if (atomMutexCreate (&mutex1) == ATOM_OK) { if (atomMutexDelete (&mutex1) == ATOM_OK) { /* Success */ } else { /* Fail */ ATOMLOG (_STR("Error deleting mutex\n")); failures++; break; } } else { /* Fail */ ATOMLOG (_STR("Error creating mutex\n")); failures++; break; } } /* Test creation and deletion of mutexes: creation checks */ if (atomMutexCreate (NULL) != ATOM_OK) { /* Success */ } else { /* Fail */ ATOMLOG (_STR("Bad mutex creation checks\n")); failures++; } /* Test creation and deletion of mutexes: deletion checks */ if (atomMutexDelete (NULL) != ATOM_OK) { /* Success */ } else { /* Fail */ ATOMLOG (_STR("Bad mutex deletion checks\n")); failures++; } /* Test wakeup of threads on mutex deletion (thread blocking with no timeout) */ g_result = 0; if (atomMutexCreate (&mutex1) != ATOM_OK) { ATOMLOG (_STR("Error creating test mutex\n")); failures++; } /* Take the mutex so that the test thread will block */ else if (atomMutexGet (&mutex1, 0) != ATOM_OK) { ATOMLOG (_STR("Error taking mutex\n")); failures++; } else if (atomThreadCreate(&tcb1, TEST_THREAD_PRIO, test1_thread_func, 0, &test1_thread_stack[TEST_THREAD_STACK_SIZE - 1]) != ATOM_OK) { /* Fail */ ATOMLOG (_STR("Error creating test thread 1\n")); failures++; } else { /* * We have created a mutex and taken ownership ourselves. We * want to see that the other thread is woken up if its mutex * is deleted. This is indicated through g_result being set. */ /* Wait for the other thread to start blocking on mutex1 */ if (atomTimerDelay(SYSTEM_TICKS_PER_SEC) != ATOM_OK) { ATOMLOG (_STR("Failed timer delay\n")); failures++; } else { /* The other thread will be blocking on mutex1 now, delete mutex1 */ if (atomMutexDelete(&mutex1) != ATOM_OK) { ATOMLOG (_STR("Failed mutex1 delete\n")); failures++; } else { /* Mutex1 deleted. The thread should now wake up and set g_result. */ atomTimerDelay (SYSTEM_TICKS_PER_SEC); if (g_result == 0) { ATOMLOG (_STR("Notify fail\n")); failures++; } else { /* Success */ } } } } /* Test wakeup of threads on semaphore deletion (thread blocking with timeout) */ g_result = 0; if (atomMutexCreate (&mutex1) != ATOM_OK) { ATOMLOG (_STR("Error creating test mutex\n")); failures++; } /* Take the mutex so that the test thread will block */ else if (atomMutexGet (&mutex1, 0) != ATOM_OK) { ATOMLOG (_STR("Error taking mutex\n")); failures++; } else if (atomThreadCreate(&tcb2, TEST_THREAD_PRIO, test2_thread_func, 0, &test2_thread_stack[TEST_THREAD_STACK_SIZE - 1]) != ATOM_OK) { /* Fail */ ATOMLOG (_STR("Error creating test thread 2\n")); failures++; } else { /* * We have created a mutex and taken ownership ourselves. We * want to see that the other thread is woken up if its mutex * is deleted. This is indicated through g_result being set. */ /* Wait for the other thread to start blocking on mutex1 */ if (atomTimerDelay(SYSTEM_TICKS_PER_SEC) != ATOM_OK) { ATOMLOG (_STR("Failed timer delay\n")); failures++; } else { /* The other thread will be blocking on mutex1 now, delete mutex1 */ if (atomMutexDelete(&mutex1) != ATOM_OK) { ATOMLOG (_STR("Failed mutex1 delete\n")); failures++; } else { /* Mutex1 deleted. The thread should now wake up and set g_result. */ atomTimerDelay (SYSTEM_TICKS_PER_SEC); if (g_result == 0) { ATOMLOG (_STR("Notify fail\n")); failures++; } else { /* Success */ } } } } /* Log final status */ if (failures == 0) { ATOMLOG (_STR("Pass\n")); } else { ATOMLOG (_STR("Fail(%d)\n"), failures); } /* Quit */ return failures; } /** * \b test1_thread_func * * Entry point for test thread 1. * * @param[in] data Unused (optional thread entry parameter) * * @return None */ static void test1_thread_func (uint32_t data) { uint8_t status; /* * Wait on mutex1 with no timeout. We are expecting to be woken up * by the main thread while blocking. */ status = atomMutexGet(&mutex1, 0); if (status != ATOM_ERR_DELETED) { ATOMLOG (_STR("Test1 thread woke without deletion (%d)\n"), status); } else { /* We were woken due to deletion as expected, set g_result to notify success */ g_result = 1; } /* Wait forever */ while (1) { atomTimerDelay (SYSTEM_TICKS_PER_SEC); } } /** * \b test2_thread_func * * Entry point for test thread 2. * * @param[in] data Unused (optional thread entry parameter) * * @return None */ static void test2_thread_func (uint32_t data) { uint8_t status; /* * Wait on mutex1 with timeout. We are expecting to be woken up * by the main thread while blocking. */ status = atomMutexGet(&mutex1, (5 * SYSTEM_TICKS_PER_SEC)); if (status != ATOM_ERR_DELETED) { ATOMLOG (_STR("Test2 thread woke without deletion (%d)\n"), status); } else { /* We were woken due to deletion as expected, set g_result to notify success */ g_result = 1; } /* Wait forever */ while (1) { atomTimerDelay (SYSTEM_TICKS_PER_SEC); } }