Maxim nexpaq / nexpaq_dev

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.

rtos/rtx/TARGET_ARM7/rt_Mutex.c@0:6c56fb4bc5f0, 2016-11-04 (annotated)

Committer:
nexpaq
Date:
Fri Nov 04 20:27:58 2016 +0000
Revision:
0:6c56fb4bc5f0
Moving to library for sharing updates

Who changed what in which revision?

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