Alan Ffrench / Mbed 2 deprecated Experiment_2_5

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.

Dependencies:   mbed

mbed-rtos/rtx/rt_Event.c@0:52468b19aa21, 2020-07-29 (annotated)

Committer:
alanffrench
Date:
Wed Jul 29 18:51:38 2020 +0000
Revision:
0:52468b19aa21
Threads

Who changed what in which revision?

UserRevisionLine numberNew contents of line
alanffrench 0:52468b19aa21 1 /*----------------------------------------------------------------------------
alanffrench 0:52468b19aa21 2 * RL-ARM - RTX
alanffrench 0:52468b19aa21 3 *----------------------------------------------------------------------------
alanffrench 0:52468b19aa21 4 * Name: RT_EVENT.C
alanffrench 0:52468b19aa21 5 * Purpose: Implements waits and wake-ups for event flags
alanffrench 0:52468b19aa21 6 * Rev.: V4.60
alanffrench 0:52468b19aa21 7 *----------------------------------------------------------------------------
alanffrench 0:52468b19aa21 8 *
alanffrench 0:52468b19aa21 9 * Copyright (c) 1999-2009 KEIL, 2009-2012 ARM Germany GmbH
alanffrench 0:52468b19aa21 10 * All rights reserved.
alanffrench 0:52468b19aa21 11 * Redistribution and use in source and binary forms, with or without
alanffrench 0:52468b19aa21 12 * modification, are permitted provided that the following conditions are met:
alanffrench 0:52468b19aa21 13 * - Redistributions of source code must retain the above copyright
alanffrench 0:52468b19aa21 14 * notice, this list of conditions and the following disclaimer.
alanffrench 0:52468b19aa21 15 * - Redistributions in binary form must reproduce the above copyright
alanffrench 0:52468b19aa21 16 * notice, this list of conditions and the following disclaimer in the
alanffrench 0:52468b19aa21 17 * documentation and/or other materials provided with the distribution.
alanffrench 0:52468b19aa21 18 * - Neither the name of ARM nor the names of its contributors may be used
alanffrench 0:52468b19aa21 19 * to endorse or promote products derived from this software without
alanffrench 0:52468b19aa21 20 * specific prior written permission.
alanffrench 0:52468b19aa21 21 *
alanffrench 0:52468b19aa21 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
alanffrench 0:52468b19aa21 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
alanffrench 0:52468b19aa21 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
alanffrench 0:52468b19aa21 25 * ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE
alanffrench 0:52468b19aa21 26 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
alanffrench 0:52468b19aa21 27 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
alanffrench 0:52468b19aa21 28 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
alanffrench 0:52468b19aa21 29 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
alanffrench 0:52468b19aa21 30 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
alanffrench 0:52468b19aa21 31 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
alanffrench 0:52468b19aa21 32 * POSSIBILITY OF SUCH DAMAGE.
alanffrench 0:52468b19aa21 33 *---------------------------------------------------------------------------*/
alanffrench 0:52468b19aa21 34
alanffrench 0:52468b19aa21 35 #include "rt_TypeDef.h"
alanffrench 0:52468b19aa21 36 #include "RTX_Config.h"
alanffrench 0:52468b19aa21 37 #include "rt_System.h"
alanffrench 0:52468b19aa21 38 #include "rt_Event.h"
alanffrench 0:52468b19aa21 39 #include "rt_List.h"
alanffrench 0:52468b19aa21 40 #include "rt_Task.h"
alanffrench 0:52468b19aa21 41 #include "rt_HAL_CM.h"
alanffrench 0:52468b19aa21 42
alanffrench 0:52468b19aa21 43
alanffrench 0:52468b19aa21 44 /*----------------------------------------------------------------------------
alanffrench 0:52468b19aa21 45 * Functions
alanffrench 0:52468b19aa21 46 *---------------------------------------------------------------------------*/
alanffrench 0:52468b19aa21 47
alanffrench 0:52468b19aa21 48
alanffrench 0:52468b19aa21 49 /*--------------------------- rt_evt_wait -----------------------------------*/
alanffrench 0:52468b19aa21 50
alanffrench 0:52468b19aa21 51 OS_RESULT rt_evt_wait (U16 wait_flags, U16 timeout, BOOL and_wait) {
alanffrench 0:52468b19aa21 52 /* Wait for one or more event flags with optional time-out. */
alanffrench 0:52468b19aa21 53 /* "wait_flags" identifies the flags to wait for. */
alanffrench 0:52468b19aa21 54 /* "timeout" is the time-out limit in system ticks (0xffff if no time-out) */
alanffrench 0:52468b19aa21 55 /* "and_wait" specifies the AND-ing of "wait_flags" as condition to be met */
alanffrench 0:52468b19aa21 56 /* to complete the wait. (OR-ing if set to 0). */
alanffrench 0:52468b19aa21 57 U32 block_state;
alanffrench 0:52468b19aa21 58
alanffrench 0:52468b19aa21 59 if (and_wait) {
alanffrench 0:52468b19aa21 60 /* Check for AND-connected events */
alanffrench 0:52468b19aa21 61 if ((os_tsk.run->events & wait_flags) == wait_flags) {
alanffrench 0:52468b19aa21 62 os_tsk.run->events &= ~wait_flags;
alanffrench 0:52468b19aa21 63 return (OS_R_EVT);
alanffrench 0:52468b19aa21 64 }
alanffrench 0:52468b19aa21 65 block_state = WAIT_AND;
alanffrench 0:52468b19aa21 66 }
alanffrench 0:52468b19aa21 67 else {
alanffrench 0:52468b19aa21 68 /* Check for OR-connected events */
alanffrench 0:52468b19aa21 69 if (os_tsk.run->events & wait_flags) {
alanffrench 0:52468b19aa21 70 os_tsk.run->waits = os_tsk.run->events & wait_flags;
alanffrench 0:52468b19aa21 71 os_tsk.run->events &= ~wait_flags;
alanffrench 0:52468b19aa21 72 return (OS_R_EVT);
alanffrench 0:52468b19aa21 73 }
alanffrench 0:52468b19aa21 74 block_state = WAIT_OR;
alanffrench 0:52468b19aa21 75 }
alanffrench 0:52468b19aa21 76 /* Task has to wait */
alanffrench 0:52468b19aa21 77 os_tsk.run->waits = wait_flags;
alanffrench 0:52468b19aa21 78 rt_block (timeout, (U8)block_state);
alanffrench 0:52468b19aa21 79 return (OS_R_TMO);
alanffrench 0:52468b19aa21 80 }
alanffrench 0:52468b19aa21 81
alanffrench 0:52468b19aa21 82
alanffrench 0:52468b19aa21 83 /*--------------------------- rt_evt_set ------------------------------------*/
alanffrench 0:52468b19aa21 84
alanffrench 0:52468b19aa21 85 void rt_evt_set (U16 event_flags, OS_TID task_id) {
alanffrench 0:52468b19aa21 86 /* Set one or more event flags of a selectable task. */
alanffrench 0:52468b19aa21 87 P_TCB p_tcb;
alanffrench 0:52468b19aa21 88
alanffrench 0:52468b19aa21 89 p_tcb = os_active_TCB[task_id-1];
alanffrench 0:52468b19aa21 90 if (p_tcb == NULL) {
alanffrench 0:52468b19aa21 91 return;
alanffrench 0:52468b19aa21 92 }
alanffrench 0:52468b19aa21 93 p_tcb->events |= event_flags;
alanffrench 0:52468b19aa21 94 event_flags = p_tcb->waits;
alanffrench 0:52468b19aa21 95 /* If the task is not waiting for an event, it should not be put */
alanffrench 0:52468b19aa21 96 /* to ready state. */
alanffrench 0:52468b19aa21 97 if (p_tcb->state == WAIT_AND) {
alanffrench 0:52468b19aa21 98 /* Check for AND-connected events */
alanffrench 0:52468b19aa21 99 if ((p_tcb->events & event_flags) == event_flags) {
alanffrench 0:52468b19aa21 100 goto wkup;
alanffrench 0:52468b19aa21 101 }
alanffrench 0:52468b19aa21 102 }
alanffrench 0:52468b19aa21 103 if (p_tcb->state == WAIT_OR) {
alanffrench 0:52468b19aa21 104 /* Check for OR-connected events */
alanffrench 0:52468b19aa21 105 if (p_tcb->events & event_flags) {
alanffrench 0:52468b19aa21 106 p_tcb->waits &= p_tcb->events;
alanffrench 0:52468b19aa21 107 wkup: p_tcb->events &= ~event_flags;
alanffrench 0:52468b19aa21 108 rt_rmv_dly (p_tcb);
alanffrench 0:52468b19aa21 109 p_tcb->state = READY;
alanffrench 0:52468b19aa21 110 #ifdef __CMSIS_RTOS
alanffrench 0:52468b19aa21 111 rt_ret_val2(p_tcb, 0x08/*osEventSignal*/, p_tcb->waits);
alanffrench 0:52468b19aa21 112 #else
alanffrench 0:52468b19aa21 113 rt_ret_val (p_tcb, OS_R_EVT);
alanffrench 0:52468b19aa21 114 #endif
alanffrench 0:52468b19aa21 115 rt_dispatch (p_tcb);
alanffrench 0:52468b19aa21 116 }
alanffrench 0:52468b19aa21 117 }
alanffrench 0:52468b19aa21 118 }
alanffrench 0:52468b19aa21 119
alanffrench 0:52468b19aa21 120
alanffrench 0:52468b19aa21 121 /*--------------------------- rt_evt_clr ------------------------------------*/
alanffrench 0:52468b19aa21 122
alanffrench 0:52468b19aa21 123 void rt_evt_clr (U16 clear_flags, OS_TID task_id) {
alanffrench 0:52468b19aa21 124 /* Clear one or more event flags (identified by "clear_flags") of a */
alanffrench 0:52468b19aa21 125 /* selectable task (identified by "task"). */
alanffrench 0:52468b19aa21 126 P_TCB task = os_active_TCB[task_id-1];
alanffrench 0:52468b19aa21 127
alanffrench 0:52468b19aa21 128 if (task == NULL) {
alanffrench 0:52468b19aa21 129 return;
alanffrench 0:52468b19aa21 130 }
alanffrench 0:52468b19aa21 131 task->events &= ~clear_flags;
alanffrench 0:52468b19aa21 132 }
alanffrench 0:52468b19aa21 133
alanffrench 0:52468b19aa21 134
alanffrench 0:52468b19aa21 135 /*--------------------------- isr_evt_set -----------------------------------*/
alanffrench 0:52468b19aa21 136
alanffrench 0:52468b19aa21 137 void isr_evt_set (U16 event_flags, OS_TID task_id) {
alanffrench 0:52468b19aa21 138 /* Same function as "os_evt_set", but to be called by ISRs. */
alanffrench 0:52468b19aa21 139 P_TCB p_tcb = os_active_TCB[task_id-1];
alanffrench 0:52468b19aa21 140
alanffrench 0:52468b19aa21 141 if (p_tcb == NULL) {
alanffrench 0:52468b19aa21 142 return;
alanffrench 0:52468b19aa21 143 }
alanffrench 0:52468b19aa21 144 rt_psq_enq (p_tcb, event_flags);
alanffrench 0:52468b19aa21 145 rt_psh_req ();
alanffrench 0:52468b19aa21 146 }
alanffrench 0:52468b19aa21 147
alanffrench 0:52468b19aa21 148
alanffrench 0:52468b19aa21 149 /*--------------------------- rt_evt_get ------------------------------------*/
alanffrench 0:52468b19aa21 150
alanffrench 0:52468b19aa21 151 U16 rt_evt_get (void) {
alanffrench 0:52468b19aa21 152 /* Get events of a running task after waiting for OR connected events. */
alanffrench 0:52468b19aa21 153 return (os_tsk.run->waits);
alanffrench 0:52468b19aa21 154 }
alanffrench 0:52468b19aa21 155
alanffrench 0:52468b19aa21 156
alanffrench 0:52468b19aa21 157 /*--------------------------- rt_evt_psh ------------------------------------*/
alanffrench 0:52468b19aa21 158
alanffrench 0:52468b19aa21 159 void rt_evt_psh (P_TCB p_CB, U16 set_flags) {
alanffrench 0:52468b19aa21 160 /* Check if task has to be waken up */
alanffrench 0:52468b19aa21 161 U16 event_flags;
alanffrench 0:52468b19aa21 162
alanffrench 0:52468b19aa21 163 p_CB->events |= set_flags;
alanffrench 0:52468b19aa21 164 event_flags = p_CB->waits;
alanffrench 0:52468b19aa21 165 if (p_CB->state == WAIT_AND) {
alanffrench 0:52468b19aa21 166 /* Check for AND-connected events */
alanffrench 0:52468b19aa21 167 if ((p_CB->events & event_flags) == event_flags) {
alanffrench 0:52468b19aa21 168 goto rdy;
alanffrench 0:52468b19aa21 169 }
alanffrench 0:52468b19aa21 170 }
alanffrench 0:52468b19aa21 171 if (p_CB->state == WAIT_OR) {
alanffrench 0:52468b19aa21 172 /* Check for OR-connected events */
alanffrench 0:52468b19aa21 173 if (p_CB->events & event_flags) {
alanffrench 0:52468b19aa21 174 p_CB->waits &= p_CB->events;
alanffrench 0:52468b19aa21 175 rdy: p_CB->events &= ~event_flags;
alanffrench 0:52468b19aa21 176 rt_rmv_dly (p_CB);
alanffrench 0:52468b19aa21 177 p_CB->state = READY;
alanffrench 0:52468b19aa21 178 #ifdef __CMSIS_RTOS
alanffrench 0:52468b19aa21 179 rt_ret_val2(p_CB, 0x08/*osEventSignal*/, p_CB->waits);
alanffrench 0:52468b19aa21 180 #else
alanffrench 0:52468b19aa21 181 rt_ret_val (p_CB, OS_R_EVT);
alanffrench 0:52468b19aa21 182 #endif
alanffrench 0:52468b19aa21 183 rt_put_prio (&os_rdy, p_CB);
alanffrench 0:52468b19aa21 184 }
alanffrench 0:52468b19aa21 185 }
alanffrench 0:52468b19aa21 186 }
alanffrench 0:52468b19aa21 187
alanffrench 0:52468b19aa21 188 /*----------------------------------------------------------------------------
alanffrench 0:52468b19aa21 189 * end of file
alanffrench 0:52468b19aa21 190 *---------------------------------------------------------------------------*/