tool/mbed/mbed-sdk/libraries/rtos/rtx/TARGET_CORTEX_M/rt_Event.c

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