Arlindo Montagnoli / Mbed 2 deprecated ProjetoBB

ProjetoBB

Dependencies:   F7_Ethernet WebSocketClient mbed mcp3008

Fork of Nucleo_F746ZG_Ethernet by Dieter Graef

mbed-rtos/rtx/TARGET_CORTEX_A/rt_Mutex.c@0:f9b6112278fe, 2016-06-18 (annotated)

Committer:
DieterGraef
Date:
Sat Jun 18 10:49:12 2016 +0000
Revision:
0:f9b6112278fe
Ethernet for the NUCLEO STM32F746 Board Testprogram uses DHCP and NTP to set the clock

Who changed what in which revision?

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