Austin Blackstone / Mbed 2 deprecated client-lwip-lightswitch-demo-expanded

mbed client lightswitch demo

Dependencies:   mbed Socket lwip-eth lwip-sys lwip

Fork of mbed-client-classic-example-lwip by Austin Blackstone

mbed-rtos/rtx/TARGET_CORTEX_A/rt_Mutex.c@11:cada08fc8a70, 2016-06-09 (annotated)

Committer:
mbedAustin
Date:
Thu Jun 09 17:08:36 2016 +0000
Revision:
11:cada08fc8a70
Commit for public Consumption

Who changed what in which revision?

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