ELEC2645 (2018/19) / Mbed 2 deprecated el17dg

Initial publish

Dependencies:   mbed

Fork of el17dg by Dmitrijs Griskovs

mbed-rtos/rtx/TARGET_ARM7/rt_Mutex.c@40:e3bbda7444fa, 2019-05-07 (annotated)

Committer:
Noximilien
Date:
Tue May 07 15:22:35 2019 +0000
Revision:
40:e3bbda7444fa
Parent:
1:5aa2312d3e94 
The Final, Submission Version. I have read and agreed to the academic integrity. SID:201160286

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Noximilien 1:5aa2312d3e94 1 /*----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 2 * RL-ARM - RTX
Noximilien 1:5aa2312d3e94 3 *----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 4 * Name: RT_MUTEX.C
Noximilien 1:5aa2312d3e94 5 * Purpose: Implements mutex synchronization objects
Noximilien 1:5aa2312d3e94 6 * Rev.: V4.60
Noximilien 1:5aa2312d3e94 7 *----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 8 *
Noximilien 1:5aa2312d3e94 9 * Copyright (c) 1999-2009 KEIL, 2009-2015 ARM Germany GmbH
Noximilien 1:5aa2312d3e94 10 * All rights reserved.
Noximilien 1:5aa2312d3e94 11 * Redistribution and use in source and binary forms, with or without
Noximilien 1:5aa2312d3e94 12 * modification, are permitted provided that the following conditions are met:
Noximilien 1:5aa2312d3e94 13 * - Redistributions of source code must retain the above copyright
Noximilien 1:5aa2312d3e94 14 * notice, this list of conditions and the following disclaimer.
Noximilien 1:5aa2312d3e94 15 * - Redistributions in binary form must reproduce the above copyright
Noximilien 1:5aa2312d3e94 16 * notice, this list of conditions and the following disclaimer in the
Noximilien 1:5aa2312d3e94 17 * documentation and/or other materials provided with the distribution.
Noximilien 1:5aa2312d3e94 18 * - Neither the name of ARM nor the names of its contributors may be used
Noximilien 1:5aa2312d3e94 19 * to endorse or promote products derived from this software without
Noximilien 1:5aa2312d3e94 20 * specific prior written permission.
Noximilien 1:5aa2312d3e94 21 *
Noximilien 1:5aa2312d3e94 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Noximilien 1:5aa2312d3e94 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Noximilien 1:5aa2312d3e94 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
Noximilien 1:5aa2312d3e94 25 * ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE
Noximilien 1:5aa2312d3e94 26 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
Noximilien 1:5aa2312d3e94 27 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
Noximilien 1:5aa2312d3e94 28 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
Noximilien 1:5aa2312d3e94 29 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
Noximilien 1:5aa2312d3e94 30 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
Noximilien 1:5aa2312d3e94 31 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
Noximilien 1:5aa2312d3e94 32 * POSSIBILITY OF SUCH DAMAGE.
Noximilien 1:5aa2312d3e94 33 *---------------------------------------------------------------------------*/
Noximilien 1:5aa2312d3e94 34
Noximilien 1:5aa2312d3e94 35 #include "rt_TypeDef.h"
Noximilien 1:5aa2312d3e94 36 #include "RTX_Conf.h"
Noximilien 1:5aa2312d3e94 37 #include "rt_List.h"
Noximilien 1:5aa2312d3e94 38 #include "rt_Task.h"
Noximilien 1:5aa2312d3e94 39 #include "rt_Mutex.h"
Noximilien 1:5aa2312d3e94 40 #include "rt_HAL_CM.h"
Noximilien 1:5aa2312d3e94 41
Noximilien 1:5aa2312d3e94 42
Noximilien 1:5aa2312d3e94 43 /*----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 44 * Functions
Noximilien 1:5aa2312d3e94 45 *---------------------------------------------------------------------------*/
Noximilien 1:5aa2312d3e94 46
Noximilien 1:5aa2312d3e94 47
Noximilien 1:5aa2312d3e94 48 /*--------------------------- rt_mut_init -----------------------------------*/
Noximilien 1:5aa2312d3e94 49
Noximilien 1:5aa2312d3e94 50 void rt_mut_init (OS_ID mutex) {
Noximilien 1:5aa2312d3e94 51 /* Initialize a mutex object */
Noximilien 1:5aa2312d3e94 52 P_MUCB p_MCB = mutex;
Noximilien 1:5aa2312d3e94 53
Noximilien 1:5aa2312d3e94 54 p_MCB->cb_type = MUCB;
Noximilien 1:5aa2312d3e94 55 p_MCB->prio = 0;
Noximilien 1:5aa2312d3e94 56 p_MCB->level = 0;
Noximilien 1:5aa2312d3e94 57 p_MCB->p_lnk = NULL;
Noximilien 1:5aa2312d3e94 58 p_MCB->owner = NULL;
Noximilien 1:5aa2312d3e94 59 }
Noximilien 1:5aa2312d3e94 60
Noximilien 1:5aa2312d3e94 61
Noximilien 1:5aa2312d3e94 62 /*--------------------------- rt_mut_delete ---------------------------------*/
Noximilien 1:5aa2312d3e94 63
Noximilien 1:5aa2312d3e94 64 #ifdef __CMSIS_RTOS
Noximilien 1:5aa2312d3e94 65 OS_RESULT rt_mut_delete (OS_ID mutex) {
Noximilien 1:5aa2312d3e94 66 /* Delete a mutex object */
Noximilien 1:5aa2312d3e94 67 P_MUCB p_MCB = mutex;
Noximilien 1:5aa2312d3e94 68 P_TCB p_TCB;
Noximilien 1:5aa2312d3e94 69
Noximilien 1:5aa2312d3e94 70 /* Restore owner task's priority. */
Noximilien 1:5aa2312d3e94 71 if (p_MCB->level != 0) {
Noximilien 1:5aa2312d3e94 72 p_MCB->owner->prio = p_MCB->prio;
Noximilien 1:5aa2312d3e94 73 if (p_MCB->owner != os_tsk.run) {
Noximilien 1:5aa2312d3e94 74 rt_resort_prio (p_MCB->owner);
Noximilien 1:5aa2312d3e94 75 }
Noximilien 1:5aa2312d3e94 76 }
Noximilien 1:5aa2312d3e94 77
Noximilien 1:5aa2312d3e94 78 while (p_MCB->p_lnk != NULL) {
Noximilien 1:5aa2312d3e94 79 /* A task is waiting for mutex. */
Noximilien 1:5aa2312d3e94 80 p_TCB = rt_get_first ((P_XCB)p_MCB);
Noximilien 1:5aa2312d3e94 81 rt_ret_val(p_TCB, 0/*osOK*/);
Noximilien 1:5aa2312d3e94 82 rt_rmv_dly(p_TCB);
Noximilien 1:5aa2312d3e94 83 p_TCB->state = READY;
Noximilien 1:5aa2312d3e94 84 rt_put_prio (&os_rdy, p_TCB);
Noximilien 1:5aa2312d3e94 85 }
Noximilien 1:5aa2312d3e94 86
Noximilien 1:5aa2312d3e94 87 if (os_rdy.p_lnk && (os_rdy.p_lnk->prio > os_tsk.run->prio)) {
Noximilien 1:5aa2312d3e94 88 /* preempt running task */
Noximilien 1:5aa2312d3e94 89 rt_put_prio (&os_rdy, os_tsk.run);
Noximilien 1:5aa2312d3e94 90 os_tsk.run->state = READY;
Noximilien 1:5aa2312d3e94 91 rt_dispatch (NULL);
Noximilien 1:5aa2312d3e94 92 }
Noximilien 1:5aa2312d3e94 93
Noximilien 1:5aa2312d3e94 94 p_MCB->cb_type = 0;
Noximilien 1:5aa2312d3e94 95
Noximilien 1:5aa2312d3e94 96 return (OS_R_OK);
Noximilien 1:5aa2312d3e94 97 }
Noximilien 1:5aa2312d3e94 98 #endif
Noximilien 1:5aa2312d3e94 99
Noximilien 1:5aa2312d3e94 100
Noximilien 1:5aa2312d3e94 101 /*--------------------------- rt_mut_release --------------------------------*/
Noximilien 1:5aa2312d3e94 102
Noximilien 1:5aa2312d3e94 103 OS_RESULT rt_mut_release (OS_ID mutex) {
Noximilien 1:5aa2312d3e94 104 /* Release a mutex object */
Noximilien 1:5aa2312d3e94 105 P_MUCB p_MCB = mutex;
Noximilien 1:5aa2312d3e94 106 P_TCB p_TCB;
Noximilien 1:5aa2312d3e94 107
Noximilien 1:5aa2312d3e94 108 if (p_MCB->level == 0 || p_MCB->owner != os_tsk.run) {
Noximilien 1:5aa2312d3e94 109 /* Unbalanced mutex release or task is not the owner */
Noximilien 1:5aa2312d3e94 110 return (OS_R_NOK);
Noximilien 1:5aa2312d3e94 111 }
Noximilien 1:5aa2312d3e94 112 if (--p_MCB->level != 0) {
Noximilien 1:5aa2312d3e94 113 return (OS_R_OK);
Noximilien 1:5aa2312d3e94 114 }
Noximilien 1:5aa2312d3e94 115 /* Restore owner task's priority. */
Noximilien 1:5aa2312d3e94 116 os_tsk.run->prio = p_MCB->prio;
Noximilien 1:5aa2312d3e94 117 if (p_MCB->p_lnk != NULL) {
Noximilien 1:5aa2312d3e94 118 /* A task is waiting for mutex. */
Noximilien 1:5aa2312d3e94 119 p_TCB = rt_get_first ((P_XCB)p_MCB);
Noximilien 1:5aa2312d3e94 120 #ifdef __CMSIS_RTOS
Noximilien 1:5aa2312d3e94 121 rt_ret_val(p_TCB, 0/*osOK*/);
Noximilien 1:5aa2312d3e94 122 #else
Noximilien 1:5aa2312d3e94 123 rt_ret_val(p_TCB, OS_R_MUT);
Noximilien 1:5aa2312d3e94 124 #endif
Noximilien 1:5aa2312d3e94 125 rt_rmv_dly (p_TCB);
Noximilien 1:5aa2312d3e94 126 /* A waiting task becomes the owner of this mutex. */
Noximilien 1:5aa2312d3e94 127 p_MCB->level = 1;
Noximilien 1:5aa2312d3e94 128 p_MCB->owner = p_TCB;
Noximilien 1:5aa2312d3e94 129 p_MCB->prio = p_TCB->prio;
Noximilien 1:5aa2312d3e94 130 /* Priority inversion, check which task continues. */
Noximilien 1:5aa2312d3e94 131 if (os_tsk.run->prio >= rt_rdy_prio()) {
Noximilien 1:5aa2312d3e94 132 rt_dispatch (p_TCB);
Noximilien 1:5aa2312d3e94 133 }
Noximilien 1:5aa2312d3e94 134 else {
Noximilien 1:5aa2312d3e94 135 /* Ready task has higher priority than running task. */
Noximilien 1:5aa2312d3e94 136 rt_put_prio (&os_rdy, os_tsk.run);
Noximilien 1:5aa2312d3e94 137 rt_put_prio (&os_rdy, p_TCB);
Noximilien 1:5aa2312d3e94 138 os_tsk.run->state = READY;
Noximilien 1:5aa2312d3e94 139 p_TCB->state = READY;
Noximilien 1:5aa2312d3e94 140 rt_dispatch (NULL);
Noximilien 1:5aa2312d3e94 141 }
Noximilien 1:5aa2312d3e94 142 }
Noximilien 1:5aa2312d3e94 143 else {
Noximilien 1:5aa2312d3e94 144 /* Check if own priority raised by priority inversion. */
Noximilien 1:5aa2312d3e94 145 if (rt_rdy_prio() > os_tsk.run->prio) {
Noximilien 1:5aa2312d3e94 146 rt_put_prio (&os_rdy, os_tsk.run);
Noximilien 1:5aa2312d3e94 147 os_tsk.run->state = READY;
Noximilien 1:5aa2312d3e94 148 rt_dispatch (NULL);
Noximilien 1:5aa2312d3e94 149 }
Noximilien 1:5aa2312d3e94 150 }
Noximilien 1:5aa2312d3e94 151 return (OS_R_OK);
Noximilien 1:5aa2312d3e94 152 }
Noximilien 1:5aa2312d3e94 153
Noximilien 1:5aa2312d3e94 154
Noximilien 1:5aa2312d3e94 155 /*--------------------------- rt_mut_wait -----------------------------------*/
Noximilien 1:5aa2312d3e94 156
Noximilien 1:5aa2312d3e94 157 OS_RESULT rt_mut_wait (OS_ID mutex, U16 timeout) {
Noximilien 1:5aa2312d3e94 158 /* Wait for a mutex, continue when mutex is free. */
Noximilien 1:5aa2312d3e94 159 P_MUCB p_MCB = mutex;
Noximilien 1:5aa2312d3e94 160
Noximilien 1:5aa2312d3e94 161 if (p_MCB->level == 0) {
Noximilien 1:5aa2312d3e94 162 p_MCB->owner = os_tsk.run;
Noximilien 1:5aa2312d3e94 163 p_MCB->prio = os_tsk.run->prio;
Noximilien 1:5aa2312d3e94 164 goto inc;
Noximilien 1:5aa2312d3e94 165 }
Noximilien 1:5aa2312d3e94 166 if (p_MCB->owner == os_tsk.run) {
Noximilien 1:5aa2312d3e94 167 /* OK, running task is the owner of this mutex. */
Noximilien 1:5aa2312d3e94 168 inc:p_MCB->level++;
Noximilien 1:5aa2312d3e94 169 return (OS_R_OK);
Noximilien 1:5aa2312d3e94 170 }
Noximilien 1:5aa2312d3e94 171 /* Mutex owned by another task, wait until released. */
Noximilien 1:5aa2312d3e94 172 if (timeout == 0) {
Noximilien 1:5aa2312d3e94 173 return (OS_R_TMO);
Noximilien 1:5aa2312d3e94 174 }
Noximilien 1:5aa2312d3e94 175 /* Raise the owner task priority if lower than current priority. */
Noximilien 1:5aa2312d3e94 176 /* This priority inversion is called priority inheritance. */
Noximilien 1:5aa2312d3e94 177 if (p_MCB->prio < os_tsk.run->prio) {
Noximilien 1:5aa2312d3e94 178 p_MCB->owner->prio = os_tsk.run->prio;
Noximilien 1:5aa2312d3e94 179 rt_resort_prio (p_MCB->owner);
Noximilien 1:5aa2312d3e94 180 }
Noximilien 1:5aa2312d3e94 181 if (p_MCB->p_lnk != NULL) {
Noximilien 1:5aa2312d3e94 182 rt_put_prio ((P_XCB)p_MCB, os_tsk.run);
Noximilien 1:5aa2312d3e94 183 }
Noximilien 1:5aa2312d3e94 184 else {
Noximilien 1:5aa2312d3e94 185 p_MCB->p_lnk = os_tsk.run;
Noximilien 1:5aa2312d3e94 186 os_tsk.run->p_lnk = NULL;
Noximilien 1:5aa2312d3e94 187 os_tsk.run->p_rlnk = (P_TCB)p_MCB;
Noximilien 1:5aa2312d3e94 188 }
Noximilien 1:5aa2312d3e94 189 rt_block(timeout, WAIT_MUT);
Noximilien 1:5aa2312d3e94 190 return (OS_R_TMO);
Noximilien 1:5aa2312d3e94 191 }
Noximilien 1:5aa2312d3e94 192
Noximilien 1:5aa2312d3e94 193
Noximilien 1:5aa2312d3e94 194 /*----------------------------------------------------------------------------
Noximilien 1:5aa2312d3e94 195 * end of file
Noximilien 1:5aa2312d3e94 196 *---------------------------------------------------------------------------*/
Noximilien 1:5aa2312d3e94 197