2 FreeRTOS V8.0.0 - Copyright (C) 2014 Real Time Engineers Ltd.
\r
5 VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
\r
7 ***************************************************************************
\r
9 * FreeRTOS provides completely free yet professionally developed, *
\r
10 * robust, strictly quality controlled, supported, and cross *
\r
11 * platform software that has become a de facto standard. *
\r
13 * Help yourself get started quickly and support the FreeRTOS *
\r
14 * project by purchasing a FreeRTOS tutorial book, reference *
\r
15 * manual, or both from: http://www.FreeRTOS.org/Documentation *
\r
19 ***************************************************************************
\r
21 This file is part of the FreeRTOS distribution.
\r
23 FreeRTOS is free software; you can redistribute it and/or modify it under
\r
24 the terms of the GNU General Public License (version 2) as published by the
\r
25 Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception.
\r
27 >>! NOTE: The modification to the GPL is included to allow you to distribute
\r
28 >>! a combined work that includes FreeRTOS without being obliged to provide
\r
29 >>! the source code for proprietary components outside of the FreeRTOS
\r
32 FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
\r
33 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
\r
34 FOR A PARTICULAR PURPOSE. Full license text is available from the following
\r
35 link: http://www.freertos.org/a00114.html
\r
39 ***************************************************************************
\r
41 * Having a problem? Start by reading the FAQ "My application does *
\r
42 * not run, what could be wrong?" *
\r
44 * http://www.FreeRTOS.org/FAQHelp.html *
\r
46 ***************************************************************************
\r
48 http://www.FreeRTOS.org - Documentation, books, training, latest versions,
\r
49 license and Real Time Engineers Ltd. contact details.
\r
51 http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
\r
52 including FreeRTOS+Trace - an indispensable productivity tool, a DOS
\r
53 compatible FAT file system, and our tiny thread aware UDP/IP stack.
\r
55 http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High
\r
56 Integrity Systems to sell under the OpenRTOS brand. Low cost OpenRTOS
\r
57 licenses offer ticketed support, indemnification and middleware.
\r
59 http://www.SafeRTOS.com - High Integrity Systems also provide a safety
\r
60 engineered and independently SIL3 certified version for use in safety and
\r
61 mission critical applications that require provable dependability.
\r
66 /* Standard includes. */
\r
69 /* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
\r
70 all the API functions to use the MPU wrappers. That should only be done when
\r
71 task.h is included from an application file. */
\r
72 #define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
\r
74 /* FreeRTOS includes. */
\r
75 #include "FreeRTOS.h"
\r
78 #include "event_groups.h"
\r
80 /* Lint e961 and e750 are suppressed as a MISRA exception justified because the
\r
81 MPU ports require MPU_WRAPPERS_INCLUDED_FROM_API_FILE to be defined for the
\r
82 header files above, but not in this file, in order to generate the correct
\r
83 privileged Vs unprivileged linkage and placement. */
\r
84 #undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE /*lint !e961 !e750. */
\r
86 #if ( INCLUDE_xEventGroupSetBitFromISR == 1 ) && ( configUSE_TIMERS == 0 )
\r
87 #error configUSE_TIMERS must be set to 1 to make the xEventGroupSetBitFromISR() function available.
\r
90 #if ( INCLUDE_xEventGroupSetBitFromISR == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 0 )
\r
91 #error INCLUDE_xTimerPendFunctionCall must also be set to one to make the xEventGroupSetBitFromISR() function available.
\r
94 /* The following bit fields convey control information in a task's event list
\r
95 item value. It is important they don't clash with the
\r
96 taskEVENT_LIST_ITEM_VALUE_IN_USE definition. */
\r
97 #if configUSE_16_BIT_TICKS == 1
\r
98 #define eventCLEAR_EVENTS_ON_EXIT_BIT 0x0100U
\r
99 #define eventUNBLOCKED_DUE_TO_BIT_SET 0x0200U
\r
100 #define eventWAIT_FOR_ALL_BITS 0x0400U
\r
101 #define eventEVENT_BITS_CONTROL_BYTES 0xff00U
\r
103 #define eventCLEAR_EVENTS_ON_EXIT_BIT 0x01000000UL
\r
104 #define eventUNBLOCKED_DUE_TO_BIT_SET 0x02000000UL
\r
105 #define eventWAIT_FOR_ALL_BITS 0x04000000UL
\r
106 #define eventEVENT_BITS_CONTROL_BYTES 0xff000000UL
\r
109 typedef struct xEventGroupDefinition
\r
111 EventBits_t uxEventBits;
\r
112 List_t xTasksWaitingForBits; /*< List of tasks waiting for a bit to be set. */
\r
114 #if( configUSE_TRACE_FACILITY == 1 )
\r
115 UBaseType_t uxEventGroupNumber;
\r
120 /*-----------------------------------------------------------*/
\r
123 * Test the bits set in uxCurrentEventBits to see if the wait condition is met.
\r
124 * The wait condition is defined by xWaitForAllBits. If xWaitForAllBits is
\r
125 * pdTRUE then the wait condition is met if all the bits set in uxBitsToWaitFor
\r
126 * are also set in uxCurrentEventBits. If xWaitForAllBits is pdFALSE then the
\r
127 * wait condition is met if any of the bits set in uxBitsToWait for are also set
\r
128 * in uxCurrentEventBits.
\r
130 static BaseType_t prvTestWaitCondition( const EventBits_t uxCurrentEventBits, const EventBits_t uxBitsToWaitFor, const BaseType_t xWaitForAllBits );
\r
132 /*-----------------------------------------------------------*/
\r
134 EventGroupHandle_t xEventGroupCreate( void )
\r
136 EventGroup_t *pxEventBits;
\r
138 pxEventBits = pvPortMalloc( sizeof( EventGroup_t ) );
\r
139 if( pxEventBits != NULL )
\r
141 pxEventBits->uxEventBits = 0;
\r
142 vListInitialise( &( pxEventBits->xTasksWaitingForBits ) );
\r
143 traceEVENT_GROUP_CREATE( pxEventBits );
\r
147 traceEVENT_GROUP_CREATE_FAILED();
\r
150 return ( EventGroupHandle_t ) pxEventBits;
\r
152 /*-----------------------------------------------------------*/
\r
154 EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, const EventBits_t uxBitsToWaitFor, TickType_t xTicksToWait )
\r
156 EventBits_t uxOriginalBitValue, uxReturn;
\r
157 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
158 BaseType_t xAlreadyYielded;
\r
159 BaseType_t xTimeoutOccurred = pdFALSE;
\r
161 configASSERT( ( uxBitsToWaitFor & eventEVENT_BITS_CONTROL_BYTES ) == 0 );
\r
162 configASSERT( uxBitsToWaitFor != 0 );
\r
163 #if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) )
\r
165 configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) );
\r
171 uxOriginalBitValue = pxEventBits->uxEventBits;
\r
173 ( void ) xEventGroupSetBits( xEventGroup, uxBitsToSet );
\r
175 if( ( ( uxOriginalBitValue | uxBitsToSet ) & uxBitsToWaitFor ) == uxBitsToWaitFor )
\r
177 /* All the rendezvous bits are now set - no need to block. */
\r
178 uxReturn = ( uxOriginalBitValue | uxBitsToSet );
\r
180 /* Rendezvous always clear the bits. They will have been cleared
\r
181 already unless this is the only task in the rendezvous. */
\r
182 pxEventBits->uxEventBits &= uxBitsToWaitFor;
\r
188 if( xTicksToWait != ( TickType_t ) 0 )
\r
190 traceEVENT_GROUP_SYNC_BLOCK( xEventGroup, uxBitsToSet, uxBitsToWaitFor );
\r
192 /* Store the bits that the calling task is waiting for in the
\r
193 task's event list item so the kernel knows when a match is
\r
194 found. Then enter the blocked state. */
\r
195 vTaskPlaceOnUnorderedEventList( &( pxEventBits->xTasksWaitingForBits ), ( uxBitsToWaitFor | eventCLEAR_EVENTS_ON_EXIT_BIT | eventWAIT_FOR_ALL_BITS ), xTicksToWait );
\r
197 /* This assignment is obsolete as uxReturn will get set after
\r
198 the task unblocks, but some compilers mistakenly generate a
\r
199 warning about uxReturn being returned without being set if the
\r
200 assignment is omitted. */
\r
205 /* The rendezvous bits were not set, but no block time was
\r
206 specified - just return the current event bit value. */
\r
207 uxReturn = pxEventBits->uxEventBits;
\r
211 xAlreadyYielded = xTaskResumeAll();
\r
213 if( xTicksToWait != ( TickType_t ) 0 )
\r
215 if( xAlreadyYielded == pdFALSE )
\r
217 portYIELD_WITHIN_API();
\r
221 mtCOVERAGE_TEST_MARKER();
\r
224 /* The task blocked to wait for its required bits to be set - at this
\r
225 point either the required bits were set or the block time expired. If
\r
226 the required bits were set they will have been stored in the task's
\r
227 event list item, and they should now be retrieved then cleared. */
\r
228 uxReturn = uxTaskResetEventItemValue();
\r
230 if( ( uxReturn & eventUNBLOCKED_DUE_TO_BIT_SET ) == ( EventBits_t ) 0 )
\r
232 /* The task timed out, just return the current event bit value. */
\r
233 taskENTER_CRITICAL();
\r
235 uxReturn = pxEventBits->uxEventBits;
\r
237 /* Although the task got here because it timed out before the
\r
238 bits it was waiting for were set, it is possible that since it
\r
239 unblocked another task has set the bits. If this is the case
\r
240 then it may be required to clear the bits before exiting. */
\r
241 if( ( uxReturn & uxBitsToWaitFor ) == uxBitsToWaitFor )
\r
243 pxEventBits->uxEventBits &= ~uxBitsToWaitFor;
\r
247 mtCOVERAGE_TEST_MARKER();
\r
250 taskEXIT_CRITICAL();
\r
252 xTimeoutOccurred = pdTRUE;
\r
256 /* The task unblocked because the bits were set. Clear the control
\r
257 bits before returning the value. */
\r
258 uxReturn &= ~eventEVENT_BITS_CONTROL_BYTES;
\r
262 traceEVENT_GROUP_SYNC_END( xEventGroup, uxBitsToSet, uxBitsToWaitFor, xTimeoutOccurred );
\r
265 /*-----------------------------------------------------------*/
\r
267 EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToWaitFor, const BaseType_t xClearOnExit, const BaseType_t xWaitForAllBits, TickType_t xTicksToWait )
\r
269 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
270 EventBits_t uxReturn, uxControlBits = 0;
\r
271 BaseType_t xWaitConditionMet, xAlreadyYielded;
\r
272 BaseType_t xTimeoutOccurred = pdFALSE;
\r
274 /* Check the user is not attempting to wait on the bits used by the kernel
\r
275 itself, and that at least one bit is being requested. */
\r
276 configASSERT( ( uxBitsToWaitFor & eventEVENT_BITS_CONTROL_BYTES ) == 0 );
\r
277 configASSERT( uxBitsToWaitFor != 0 );
\r
278 #if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) )
\r
280 configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) );
\r
286 const EventBits_t uxCurrentEventBits = pxEventBits->uxEventBits;
\r
288 /* Check to see if the wait condition is already met or not. */
\r
289 xWaitConditionMet = prvTestWaitCondition( uxCurrentEventBits, uxBitsToWaitFor, xWaitForAllBits );
\r
291 if( xWaitConditionMet != pdFALSE )
\r
293 /* The wait condition has already been met so there is no need to
\r
295 uxReturn = uxCurrentEventBits;
\r
296 xTicksToWait = ( TickType_t ) 0;
\r
298 /* Clear the wait bits if requested to do so. */
\r
299 if( xClearOnExit != pdFALSE )
\r
301 pxEventBits->uxEventBits &= ~uxBitsToWaitFor;
\r
305 mtCOVERAGE_TEST_MARKER();
\r
308 else if( xTicksToWait == ( TickType_t ) 0 )
\r
310 /* The wait condition has not been met, but no block time was
\r
311 specified, so just return the current value. */
\r
312 uxReturn = uxCurrentEventBits;
\r
316 /* The task is going to block to wait for its required bits to be
\r
317 set. uxControlBits are used to remember the specified behaviour of
\r
318 this call to xEventGroupWaitBits() - for use when the event bits
\r
319 unblock the task. */
\r
320 if( xClearOnExit != pdFALSE )
\r
322 uxControlBits |= eventCLEAR_EVENTS_ON_EXIT_BIT;
\r
326 mtCOVERAGE_TEST_MARKER();
\r
329 if( xWaitForAllBits != pdFALSE )
\r
331 uxControlBits |= eventWAIT_FOR_ALL_BITS;
\r
335 mtCOVERAGE_TEST_MARKER();
\r
338 /* Store the bits that the calling task is waiting for in the
\r
339 task's event list item so the kernel knows when a match is
\r
340 found. Then enter the blocked state. */
\r
341 vTaskPlaceOnUnorderedEventList( &( pxEventBits->xTasksWaitingForBits ), ( uxBitsToWaitFor | uxControlBits ), xTicksToWait );
\r
343 /* This is obsolete as it will get set after the task unblocks, but
\r
344 some compilers mistakenly generate a warning about the variable
\r
345 being returned without being set if it is not done. */
\r
348 traceEVENT_GROUP_WAIT_BITS_BLOCK( xEventGroup, uxBitsToWaitFor );
\r
351 xAlreadyYielded = xTaskResumeAll();
\r
353 if( xTicksToWait != ( TickType_t ) 0 )
\r
355 if( xAlreadyYielded == pdFALSE )
\r
357 portYIELD_WITHIN_API();
\r
361 mtCOVERAGE_TEST_MARKER();
\r
364 /* The task blocked to wait for its required bits to be set - at this
\r
365 point either the required bits were set or the block time expired. If
\r
366 the required bits were set they will have been stored in the task's
\r
367 event list item, and they should now be retrieved then cleared. */
\r
368 uxReturn = uxTaskResetEventItemValue();
\r
370 if( ( uxReturn & eventUNBLOCKED_DUE_TO_BIT_SET ) == ( EventBits_t ) 0 )
\r
372 taskENTER_CRITICAL();
\r
374 /* The task timed out, just return the current event bit value. */
\r
375 uxReturn = pxEventBits->uxEventBits;
\r
377 /* It is possible that the event bits were updated between this
\r
378 task leaving the Blocked state and running again. */
\r
379 if( prvTestWaitCondition( uxReturn, uxBitsToWaitFor, xWaitForAllBits ) != pdFALSE )
\r
381 if( xClearOnExit != pdFALSE )
\r
383 pxEventBits->uxEventBits &= ~uxBitsToWaitFor;
\r
387 mtCOVERAGE_TEST_MARKER();
\r
392 mtCOVERAGE_TEST_MARKER();
\r
395 taskEXIT_CRITICAL();
\r
397 xTimeoutOccurred = pdFALSE;
\r
401 /* The task unblocked because the bits were set. Clear the control
\r
402 bits before returning the value. */
\r
403 uxReturn &= ~eventEVENT_BITS_CONTROL_BYTES;
\r
406 traceEVENT_GROUP_WAIT_BITS_END( xEventGroup, uxBitsToWaitFor, xTimeoutOccurred );
\r
409 /*-----------------------------------------------------------*/
\r
411 EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear )
\r
413 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
414 EventBits_t uxReturn;
\r
416 /* Check the user is not attempting to clear the bits used by the kernel
\r
418 configASSERT( ( uxBitsToClear & eventEVENT_BITS_CONTROL_BYTES ) == 0 );
\r
420 taskENTER_CRITICAL();
\r
422 traceEVENT_GROUP_CLEAR_BITS( xEventGroup, uxBitsToClear );
\r
424 /* The value returned is the event group value prior to the bits being
\r
426 uxReturn = pxEventBits->uxEventBits;
\r
428 /* Clear the bits. */
\r
429 pxEventBits->uxEventBits &= ~uxBitsToClear;
\r
431 taskEXIT_CRITICAL();
\r
435 /*-----------------------------------------------------------*/
\r
437 EventBits_t xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear )
\r
439 UBaseType_t uxSavedInterruptStatus;
\r
440 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
441 EventBits_t uxReturn;
\r
443 /* Check the user is not attempting to clear the bits used by the kernel
\r
445 configASSERT( ( uxBitsToClear & eventEVENT_BITS_CONTROL_BYTES ) == 0 );
\r
447 uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();
\r
449 traceEVENT_GROUP_CLEAR_BITS_FROM_ISR( xEventGroup, uxBitsToClear );
\r
451 /* The value returned is the event group value prior to the bits being
\r
453 uxReturn = pxEventBits->uxEventBits;
\r
455 /* Clear the bits. */
\r
456 pxEventBits->uxEventBits &= ~uxBitsToClear;
\r
458 portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
\r
462 /*-----------------------------------------------------------*/
\r
464 EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet )
\r
466 ListItem_t *pxListItem, *pxNext;
\r
467 ListItem_t const *pxListEnd;
\r
469 EventBits_t uxBitsToClear = 0, uxBitsWaitedFor, uxControlBits;
\r
470 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
471 BaseType_t xMatchFound = pdFALSE;
\r
473 /* Check the user is not attempting to set the bits used by the kernel
\r
475 configASSERT( ( uxBitsToSet & eventEVENT_BITS_CONTROL_BYTES ) == 0 );
\r
477 pxList = &( pxEventBits->xTasksWaitingForBits );
\r
478 pxListEnd = listGET_END_MARKER( pxList ); /*lint !e826 !e740 The mini list structure is used as the list end to save RAM. This is checked and valid. */
\r
481 traceEVENT_GROUP_SET_BITS( xEventGroup, uxBitsToSet );
\r
483 pxListItem = listGET_HEAD_ENTRY( pxList );
\r
485 /* Set the bits. */
\r
486 pxEventBits->uxEventBits |= uxBitsToSet;
\r
488 /* See if the new bit value should unblock any tasks. */
\r
489 while( pxListItem != pxListEnd )
\r
491 pxNext = listGET_NEXT( pxListItem );
\r
492 uxBitsWaitedFor = listGET_LIST_ITEM_VALUE( pxListItem );
\r
493 xMatchFound = pdFALSE;
\r
495 /* Split the bits waited for from the control bits. */
\r
496 uxControlBits = uxBitsWaitedFor & eventEVENT_BITS_CONTROL_BYTES;
\r
497 uxBitsWaitedFor &= ~eventEVENT_BITS_CONTROL_BYTES;
\r
499 if( ( uxControlBits & eventWAIT_FOR_ALL_BITS ) == ( EventBits_t ) 0 )
\r
501 /* Just looking for single bit being set. */
\r
502 if( ( uxBitsWaitedFor & pxEventBits->uxEventBits ) != ( EventBits_t ) 0 )
\r
504 xMatchFound = pdTRUE;
\r
508 mtCOVERAGE_TEST_MARKER();
\r
511 else if( ( uxBitsWaitedFor & pxEventBits->uxEventBits ) == uxBitsWaitedFor )
\r
513 /* All bits are set. */
\r
514 xMatchFound = pdTRUE;
\r
518 /* Need all bits to be set, but not all the bits were set. */
\r
521 if( xMatchFound != pdFALSE )
\r
523 /* The bits match. Should the bits be cleared on exit? */
\r
524 if( ( uxControlBits & eventCLEAR_EVENTS_ON_EXIT_BIT ) != ( EventBits_t ) 0 )
\r
526 uxBitsToClear |= uxBitsWaitedFor;
\r
530 mtCOVERAGE_TEST_MARKER();
\r
533 /* Store the actual event flag value in the task's event list
\r
534 item before removing the task from the event list. The
\r
535 eventUNBLOCKED_DUE_TO_BIT_SET bit is set so the task knows
\r
536 that is was unblocked due to its required bits matching, rather
\r
537 than because it timed out. */
\r
538 ( void ) xTaskRemoveFromUnorderedEventList( pxListItem, pxEventBits->uxEventBits | eventUNBLOCKED_DUE_TO_BIT_SET );
\r
541 /* Move onto the next list item. Note pxListItem->pxNext is not
\r
542 used here as the list item may have been removed from the event list
\r
543 and inserted into the ready/pending reading list. */
\r
544 pxListItem = pxNext;
\r
547 /* Clear any bits that matched when the eventCLEAR_EVENTS_ON_EXIT_BIT
\r
548 bit was set in the control word. */
\r
549 pxEventBits->uxEventBits &= ~uxBitsToClear;
\r
551 ( void ) xTaskResumeAll();
\r
553 return pxEventBits->uxEventBits;
\r
555 /*-----------------------------------------------------------*/
\r
557 void vEventGroupDelete( EventGroupHandle_t xEventGroup )
\r
559 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
560 const List_t *pxTasksWaitingForBits = &( pxEventBits->xTasksWaitingForBits );
\r
564 traceEVENT_GROUP_DELETE( xEventGroup );
\r
566 while( listCURRENT_LIST_LENGTH( pxTasksWaitingForBits ) > ( UBaseType_t ) 0 )
\r
568 /* Unblock the task, returning 0 as the event list is being deleted
\r
569 and cannot therefore have any bits set. */
\r
570 configASSERT( pxTasksWaitingForBits->xListEnd.pxNext != ( ListItem_t * ) &( pxTasksWaitingForBits->xListEnd ) );
\r
571 ( void ) xTaskRemoveFromUnorderedEventList( pxTasksWaitingForBits->xListEnd.pxNext, eventUNBLOCKED_DUE_TO_BIT_SET );
\r
574 vPortFree( pxEventBits );
\r
576 ( void ) xTaskResumeAll();
\r
578 /*-----------------------------------------------------------*/
\r
580 /* For internal use only - execute a 'set bits' command that was pended from
\r
582 void vEventGroupSetBitsCallback( void *pvEventGroup, const uint32_t ulBitsToSet )
\r
584 ( void ) xEventGroupSetBits( pvEventGroup, ( EventBits_t ) ulBitsToSet );
\r
586 /*-----------------------------------------------------------*/
\r
588 static BaseType_t prvTestWaitCondition( const EventBits_t uxCurrentEventBits, const EventBits_t uxBitsToWaitFor, const BaseType_t xWaitForAllBits )
\r
590 BaseType_t xWaitConditionMet = pdFALSE;
\r
592 if( xWaitForAllBits == pdFALSE )
\r
594 /* Task only has to wait for one bit within uxBitsToWaitFor to be
\r
595 set. Is one already set? */
\r
596 if( ( uxCurrentEventBits & uxBitsToWaitFor ) != ( EventBits_t ) 0 )
\r
598 xWaitConditionMet = pdTRUE;
\r
602 mtCOVERAGE_TEST_MARKER();
\r
607 /* Task has to wait for all the bits in uxBitsToWaitFor to be set.
\r
608 Are they set already? */
\r
609 if( ( uxCurrentEventBits & uxBitsToWaitFor ) == uxBitsToWaitFor )
\r
611 xWaitConditionMet = pdTRUE;
\r
615 mtCOVERAGE_TEST_MARKER();
\r
619 return xWaitConditionMet;
\r
621 /*-----------------------------------------------------------*/
\r
623 #if ( ( configUSE_TRACE_FACILITY == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 1 ) )
\r
624 BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, BaseType_t *pxHigherPriorityTaskWoken )
\r
626 BaseType_t xReturn;
\r
628 traceEVENT_GROUP_SET_BITS_FROM_ISR( xEventGroup, uxBitsToSet );
\r
629 xReturn = xTimerPendFunctionCallFromISR( vEventGroupSetBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToSet, pxHigherPriorityTaskWoken );
\r
634 /*-----------------------------------------------------------*/
\r
636 #if (configUSE_TRACE_FACILITY == 1)
\r
637 UBaseType_t uxEventGroupGetNumber( void* xEventGroup )
\r
639 UBaseType_t xReturn;
\r
640 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
642 if( xEventGroup == NULL )
\r
648 xReturn = pxEventBits->uxEventGroupNumber;
\r