Initial commit

1 files changed, 169 insertions, 0 deletions

diff --git a/common/src/tx_thread_relinquish.c b/common/src/tx_thread_relinquish.c
new file mode 100644
index 00000000..4dcfb76c
--- /dev/null
+++ b/common/src/tx_thread_relinquish.c
@@ -0,0 +1,169 @@
+/**************************************************************************/
+/*                                                                        */
+/*       Copyright (c) Microsoft Corporation. All rights reserved.        */
+/*                                                                        */
+/*       This software is licensed under the Microsoft Software License   */
+/*       Terms for Microsoft Azure RTOS. Full text of the license can be  */
+/*       found in the LICENSE file at https://aka.ms/AzureRTOS_EULA       */
+/*       and in the root directory of this software.                      */
+/*                                                                        */
+/**************************************************************************/
+
+
+/**************************************************************************/
+/**************************************************************************/
+/**                                                                       */
+/** ThreadX Component                                                     */
+/**                                                                       */
+/**   Thread                                                              */
+/**                                                                       */
+/**************************************************************************/
+/**************************************************************************/
+
+#define TX_SOURCE_CODE
+
+
+/* Include necessary system files.  */
+
+#include "tx_api.h"
+#include "tx_trace.h"
+#include "tx_thread.h"
+#ifndef TX_NO_TIMER
+#include "tx_timer.h"
+#endif
+
+
+/**************************************************************************/
+/*                                                                        */
+/*  FUNCTION                                               RELEASE        */
+/*                                                                        */
+/*    _tx_thread_relinquish                               PORTABLE C      */
+/*                                                           6.0          */
+/*  AUTHOR                                                                */
+/*                                                                        */
+/*    William E. Lamie, Microsoft Corporation                             */
+/*                                                                        */
+/*  DESCRIPTION                                                           */
+/*                                                                        */
+/*    This function moves the currently executing thread to the end of    */
+/*    the list of threads ready at the same priority. If no other threads */
+/*    of the same or higher priority are ready, this function simply      */
+/*    returns.                                                            */
+/*                                                                        */
+/*  INPUT                                                                 */
+/*                                                                        */
+/*    None                                                                */
+/*                                                                        */
+/*  OUTPUT                                                                */
+/*                                                                        */
+/*    None                                                                */
+/*                                                                        */
+/*  CALLS                                                                 */
+/*                                                                        */
+/*    _tx_thread_system_return              Return to the system          */
+/*                                                                        */
+/*  CALLED BY                                                             */
+/*                                                                        */
+/*    Application Code                                                    */
+/*                                                                        */
+/*  RELEASE HISTORY                                                       */
+/*                                                                        */
+/*    DATE              NAME                      DESCRIPTION             */
+/*                                                                        */
+/*  05-19-2020     William E. Lamie         Initial Version 6.0           */
+/*                                                                        */
+/**************************************************************************/
+VOID  _tx_thread_relinquish(VOID)
+{
+
+TX_INTERRUPT_SAVE_AREA
+
+UINT            priority;
+TX_THREAD       *thread_ptr;
+
+
+    /* Pickup thread pointer.  */
+    TX_THREAD_GET_CURRENT(thread_ptr)
+
+#ifdef TX_ENABLE_STACK_CHECKING
+
+    /* Check this thread's stack.  */
+    TX_THREAD_STACK_CHECK(thread_ptr)
+#endif
+
+    /* Disable interrupts.  */
+    TX_DISABLE
+
+#ifndef TX_NO_TIMER
+
+    /* Reset time slice for current thread.  */
+    _tx_timer_time_slice =  thread_ptr -> tx_thread_new_time_slice;
+#endif
+
+    /* Pickup the thread's priority.  */
+    priority =  thread_ptr -> tx_thread_priority;
+
+    /* Determine if there is another thread at the same priority.  */
+    if (thread_ptr -> tx_thread_ready_next != thread_ptr)
+    {
+
+        /* Yes, there is another thread at this priority, make it the highest at
+           this priority level.  */
+        _tx_thread_priority_list[priority] =  thread_ptr -> tx_thread_ready_next;
+    
+        /* Mark the new thread as the one to execute.  */
+        _tx_thread_execute_ptr = thread_ptr -> tx_thread_ready_next;
+    }
+
+    /* Determine if there is a higher-priority thread ready.  */
+    if (_tx_thread_highest_priority < priority)
+    {
+
+        /* Yes, there is a higher priority thread ready to execute.  Make
+           it visible to the thread scheduler.  */
+        _tx_thread_execute_ptr =  _tx_thread_priority_list[_tx_thread_highest_priority];
+
+        /* No need to clear the preempted bit in this case, since the currently running
+           thread must already have its preempted bit clear.  */
+    }
+
+    /* If trace is enabled, insert this event into the trace buffer.  */
+    TX_TRACE_IN_LINE_INSERT(TX_TRACE_THREAD_RELINQUISH, &thread_ptr, TX_POINTER_TO_ULONG_CONVERT(_tx_thread_execute_ptr), 0, 0, TX_TRACE_THREAD_EVENTS)
+
+    /* Log this kernel call.  */
+    TX_EL_THREAD_RELINQUISH_INSERT
+
+    /* Restore previous interrupt posture.  */
+    TX_RESTORE
+
+    /* Determine if this thread needs to return to the system.  */
+    if (_tx_thread_execute_ptr != thread_ptr)
+    {
+
+#ifdef TX_THREAD_ENABLE_PERFORMANCE_INFO
+
+        /* Increment the number of thread relinquishes.  */
+        thread_ptr -> tx_thread_performance_relinquish_count++;
+
+        /* Increment the total number of thread relinquish operations.  */
+        _tx_thread_performance_relinquish_count++;
+
+        /* Increment the non-idle return count.  */
+        _tx_thread_performance_non_idle_return_count++;
+#endif
+
+#ifdef TX_ENABLE_STACK_CHECKING
+
+        /* Pickup the next execute pointer.  */
+        thread_ptr =  _tx_thread_execute_ptr;
+
+        /* Check this thread's stack.  */
+        TX_THREAD_STACK_CHECK(thread_ptr)
+#endif
+
+        /* Transfer control to the system so the scheduler can execute
+           the next thread.  */
+        _tx_thread_system_return();
+    }
+}
+