desp koval / mbed-rtos

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   Mecatro_Filtre

rtx/TARGET_ARM7/rt_Mutex.c@0:4a2c9c1f5b9e, 2021-03-15 (annotated)

Committer:
mecatro_prod
Date:
Mon Mar 15 14:18:11 2021 +0000
Revision:
0:4a2c9c1f5b9e
Pas de changement

Who changed what in which revision?

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