summaryrefslogtreecommitdiff
path: root/ports/linux/gnu/src/tx_thread_context_restore.c
blob: 5466b30e22b77d42c91b33cc76b8db2acd77ae68 (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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
/***************************************************************************
 * Copyright (c) 2024 Microsoft Corporation 
 * 
 * This program and the accompanying materials are made available under the
 * terms of the MIT License which is available at
 * https://opensource.org/licenses/MIT.
 * 
 * SPDX-License-Identifier: MIT
 **************************************************************************/


/**************************************************************************/
/**************************************************************************/
/**                                                                       */ 
/** ThreadX Component                                                     */ 
/**                                                                       */
/**   Thread                                                              */
/**                                                                       */
/**************************************************************************/
/**************************************************************************/


#define TX_SOURCE_CODE


/* Include necessary system files.  */

#include "tx_api.h"
#include "tx_thread.h"
#include "tx_timer.h"

extern sem_t _tx_linux_isr_semaphore;
UINT _tx_linux_timer_waiting = 0;
/**************************************************************************/ 
/*                                                                        */ 
/*  FUNCTION                                               RELEASE        */ 
/*                                                                        */ 
/*    _tx_thread_context_restore                          Linux/GNU       */ 
/*                                                           6.1          */
/*  AUTHOR                                                                */
/*                                                                        */
/*    William E. Lamie, Microsoft Corporation                             */
/*                                                                        */
/*  DESCRIPTION                                                           */
/*                                                                        */ 
/*    This function restores the interrupt context if it is processing a  */ 
/*    nested interrupt.  If not, it returns to the interrupt thread if no */ 
/*    preemption is necessary.  Otherwise, if preemption is necessary or  */ 
/*    if no thread was running, the function returns to the scheduler.    */ 
/*                                                                        */ 
/*  INPUT                                                                 */ 
/*                                                                        */ 
/*    None                                                                */ 
/*                                                                        */ 
/*  OUTPUT                                                                */ 
/*                                                                        */ 
/*    None                                                                */ 
/*                                                                        */ 
/*  CALLS                                                                 */ 
/*                                                                        */ 
/*    _tx_linux_debug_entry_insert                                        */ 
/*    tx_linux_mutex_lock                                                 */ 
/*    sem_trywait                                                         */
/*    tx_linux_sem_post                                                   */ 
/*    tx_linux_sem_wait                                                   */ 
/*    _tx_linux_thread_resume                                             */ 
/*    tx_linux_mutex_recursive_unlock                                     */ 
/*                                                                        */ 
/*  CALLED BY                                                             */ 
/*                                                                        */ 
/*    ISRs                                  Interrupt Service Routines    */ 
/*                                                                        */ 
/*  RELEASE HISTORY                                                       */ 
/*                                                                        */ 
/*    DATE              NAME                      DESCRIPTION             */
/*                                                                        */
/*  09-30-2020     William E. Lamie         Initial Version 6.1           */
/*                                                                        */
/**************************************************************************/
VOID   _tx_thread_context_restore(VOID)
{

    /* Debug entry.  */
    _tx_linux_debug_entry_insert("CONTEXT_RESTORE", __FILE__, __LINE__);

    /* Lock mutex to ensure other threads are not playing with
       the core ThreadX data structures.  */
    tx_linux_mutex_lock(_tx_linux_mutex);

    /* Decrement the nested interrupt count.  */
    _tx_thread_system_state--;

    /* Determine if this is the first nested interrupt and if a ThreadX
       application thread was running at the time.  */
    if ((!_tx_thread_system_state) && (_tx_thread_current_ptr))
    {

        /* Yes, this is the first and last interrupt processed.  */

        /* Check to see if preemption is required.  */
        if ((_tx_thread_preempt_disable == 0) && (_tx_thread_current_ptr != _tx_thread_execute_ptr))
        {

            /* Preempt the running application thread.  We don't need to suspend the 
               application thread since that is done in the context save processing.  */

            /* Indicate that this thread was suspended asynchronously.  */
            _tx_thread_current_ptr -> tx_thread_linux_suspension_type =  1;

            /* Save the remaining time-slice and disable it.  */
            if (_tx_timer_time_slice)
            {

                _tx_thread_current_ptr -> tx_thread_time_slice =  _tx_timer_time_slice;
                _tx_timer_time_slice =  0;
            }

            /* Clear the current thread pointer.  */
            _tx_thread_current_ptr =  TX_NULL;

            /* Make sure semaphore is 0. */
            while(!sem_trywait(&_tx_linux_semaphore));

            /* Indicate it is in timer ISR. */
            _tx_linux_timer_waiting = 1;

            /* Wakeup the system thread by setting the system semaphore.  */
            tx_linux_sem_post(&_tx_linux_semaphore);

            if(_tx_thread_execute_ptr)
            {
                if(_tx_thread_execute_ptr -> tx_thread_linux_suspension_type == 0)
                {

                    /* Unlock linux mutex. */
                    tx_linux_mutex_recursive_unlock(_tx_linux_mutex);

                    /* Wait until TX_THREAD start running. */
                    tx_linux_sem_wait(&_tx_linux_isr_semaphore);

                    tx_linux_mutex_lock(_tx_linux_mutex);

                    /* Make sure semaphore is 0. */
                    while(!sem_trywait(&_tx_linux_isr_semaphore));
                }
            }

            /* Indicate it is not in timer ISR. */
            _tx_linux_timer_waiting = 0;
        }
        else
        {

            /* Since preemption is not required, resume the interrupted thread.  */
            _tx_linux_thread_resume(_tx_thread_current_ptr -> tx_thread_linux_thread_id);
        }
    }

    /* Unlock linux mutex. */
    tx_linux_mutex_recursive_unlock(_tx_linux_mutex);
}