2 FreeRTOS V9.0.1 - Copyright (C) 2017 Real Time Engineers Ltd.
\r
5 VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
\r
7 This file is part of the FreeRTOS distribution.
\r
9 FreeRTOS is free software; you can redistribute it and/or modify it under
\r
10 the terms of the GNU General Public License (version 2) as published by the
\r
11 Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
\r
13 ***************************************************************************
\r
14 >>! NOTE: The modification to the GPL is included to allow you to !<<
\r
15 >>! distribute a combined work that includes FreeRTOS without being !<<
\r
16 >>! obliged to provide the source code for proprietary components !<<
\r
17 >>! outside of the FreeRTOS kernel. !<<
\r
18 ***************************************************************************
\r
20 FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
\r
21 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
\r
22 FOR A PARTICULAR PURPOSE. Full license text is available on the following
\r
23 link: http://www.freertos.org/a00114.html
\r
25 ***************************************************************************
\r
27 * FreeRTOS provides completely free yet professionally developed, *
\r
28 * robust, strictly quality controlled, supported, and cross *
\r
29 * platform software that is more than just the market leader, it *
\r
30 * is the industry's de facto standard. *
\r
32 * Help yourself get started quickly while simultaneously helping *
\r
33 * to support the FreeRTOS project by purchasing a FreeRTOS *
\r
34 * tutorial book, reference manual, or both: *
\r
35 * http://www.FreeRTOS.org/Documentation *
\r
37 ***************************************************************************
\r
39 http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading
\r
40 the FAQ page "My application does not run, what could be wrong?". Have you
\r
41 defined configASSERT()?
\r
43 http://www.FreeRTOS.org/support - In return for receiving this top quality
\r
44 embedded software for free we request you assist our global community by
\r
45 participating in the support forum.
\r
47 http://www.FreeRTOS.org/training - Investing in training allows your team to
\r
48 be as productive as possible as early as possible. Now you can receive
\r
49 FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
\r
50 Ltd, and the world's leading authority on the world's leading RTOS.
\r
52 http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
\r
53 including FreeRTOS+Trace - an indispensable productivity tool, a DOS
\r
54 compatible FAT file system, and our tiny thread aware UDP/IP stack.
\r
56 http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
\r
57 Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
\r
59 http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
\r
60 Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS
\r
61 licenses offer ticketed support, indemnification and commercial middleware.
\r
63 http://www.SafeRTOS.com - High Integrity Systems also provide a safety
\r
64 engineered and independently SIL3 certified version for use in safety and
\r
65 mission critical applications that require provable dependability.
\r
70 /* Standard includes. */
\r
73 /* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
\r
74 all the API functions to use the MPU wrappers. That should only be done when
\r
75 task.h is included from an application file. */
\r
76 #define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
\r
78 /* FreeRTOS includes. */
\r
79 #include "FreeRTOS.h"
\r
82 #include "event_groups.h"
\r
84 /* Lint e961 and e750 are suppressed as a MISRA exception justified because the
\r
85 MPU ports require MPU_WRAPPERS_INCLUDED_FROM_API_FILE to be defined for the
\r
86 header files above, but not in this file, in order to generate the correct
\r
87 privileged Vs unprivileged linkage and placement. */
\r
88 #undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE /*lint !e961 !e750. */
\r
90 /* The following bit fields convey control information in a task's event list
\r
91 item value. It is important they don't clash with the
\r
92 taskEVENT_LIST_ITEM_VALUE_IN_USE definition. */
\r
93 #if configUSE_16_BIT_TICKS == 1
\r
94 #define eventCLEAR_EVENTS_ON_EXIT_BIT 0x0100U
\r
95 #define eventUNBLOCKED_DUE_TO_BIT_SET 0x0200U
\r
96 #define eventWAIT_FOR_ALL_BITS 0x0400U
\r
97 #define eventEVENT_BITS_CONTROL_BYTES 0xff00U
\r
99 #define eventCLEAR_EVENTS_ON_EXIT_BIT 0x01000000UL
\r
100 #define eventUNBLOCKED_DUE_TO_BIT_SET 0x02000000UL
\r
101 #define eventWAIT_FOR_ALL_BITS 0x04000000UL
\r
102 #define eventEVENT_BITS_CONTROL_BYTES 0xff000000UL
\r
105 typedef struct xEventGroupDefinition
\r
107 EventBits_t uxEventBits;
\r
108 List_t xTasksWaitingForBits; /*< List of tasks waiting for a bit to be set. */
\r
110 #if( configUSE_TRACE_FACILITY == 1 )
\r
111 UBaseType_t uxEventGroupNumber;
\r
114 #if( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) )
\r
115 uint8_t ucStaticallyAllocated; /*< Set to pdTRUE if the event group is statically allocated to ensure no attempt is made to free the memory. */
\r
119 /*-----------------------------------------------------------*/
\r
122 * Test the bits set in uxCurrentEventBits to see if the wait condition is met.
\r
123 * The wait condition is defined by xWaitForAllBits. If xWaitForAllBits is
\r
124 * pdTRUE then the wait condition is met if all the bits set in uxBitsToWaitFor
\r
125 * are also set in uxCurrentEventBits. If xWaitForAllBits is pdFALSE then the
\r
126 * wait condition is met if any of the bits set in uxBitsToWait for are also set
\r
127 * in uxCurrentEventBits.
\r
129 static BaseType_t prvTestWaitCondition( const EventBits_t uxCurrentEventBits, const EventBits_t uxBitsToWaitFor, const BaseType_t xWaitForAllBits ) PRIVILEGED_FUNCTION;
\r
131 /*-----------------------------------------------------------*/
\r
133 #if( configSUPPORT_STATIC_ALLOCATION == 1 )
\r
135 EventGroupHandle_t xEventGroupCreateStatic( StaticEventGroup_t *pxEventGroupBuffer )
\r
137 EventGroup_t *pxEventBits;
\r
139 /* A StaticEventGroup_t object must be provided. */
\r
140 configASSERT( pxEventGroupBuffer );
\r
142 #if( configASSERT_DEFINED == 1 )
\r
144 /* Sanity check that the size of the structure used to declare a
\r
145 variable of type StaticEventGroup_t equals the size of the real
\r
146 event group structure. */
\r
147 volatile size_t xSize = sizeof( StaticEventGroup_t );
\r
148 configASSERT( xSize == sizeof( EventGroup_t ) );
\r
150 #endif /* configASSERT_DEFINED */
\r
152 /* The user has provided a statically allocated event group - use it. */
\r
153 pxEventBits = ( EventGroup_t * ) pxEventGroupBuffer; /*lint !e740 EventGroup_t and StaticEventGroup_t are guaranteed to have the same size and alignment requirement - checked by configASSERT(). */
\r
155 if( pxEventBits != NULL )
\r
157 pxEventBits->uxEventBits = 0;
\r
158 vListInitialise( &( pxEventBits->xTasksWaitingForBits ) );
\r
160 #if( configSUPPORT_DYNAMIC_ALLOCATION == 1 )
\r
162 /* Both static and dynamic allocation can be used, so note that
\r
163 this event group was created statically in case the event group
\r
164 is later deleted. */
\r
165 pxEventBits->ucStaticallyAllocated = pdTRUE;
\r
167 #endif /* configSUPPORT_DYNAMIC_ALLOCATION */
\r
169 traceEVENT_GROUP_CREATE( pxEventBits );
\r
173 traceEVENT_GROUP_CREATE_FAILED();
\r
176 return ( EventGroupHandle_t ) pxEventBits;
\r
179 #endif /* configSUPPORT_STATIC_ALLOCATION */
\r
180 /*-----------------------------------------------------------*/
\r
182 #if( configSUPPORT_DYNAMIC_ALLOCATION == 1 )
\r
184 EventGroupHandle_t xEventGroupCreate( void )
\r
186 EventGroup_t *pxEventBits;
\r
188 /* Allocate the event group. */
\r
189 pxEventBits = ( EventGroup_t * ) pvPortMalloc( sizeof( EventGroup_t ) );
\r
191 if( pxEventBits != NULL )
\r
193 pxEventBits->uxEventBits = 0;
\r
194 vListInitialise( &( pxEventBits->xTasksWaitingForBits ) );
\r
196 #if( configSUPPORT_STATIC_ALLOCATION == 1 )
\r
198 /* Both static and dynamic allocation can be used, so note this
\r
199 event group was allocated statically in case the event group is
\r
201 pxEventBits->ucStaticallyAllocated = pdFALSE;
\r
203 #endif /* configSUPPORT_STATIC_ALLOCATION */
\r
205 traceEVENT_GROUP_CREATE( pxEventBits );
\r
209 traceEVENT_GROUP_CREATE_FAILED();
\r
212 return ( EventGroupHandle_t ) pxEventBits;
\r
215 #endif /* configSUPPORT_DYNAMIC_ALLOCATION */
\r
216 /*-----------------------------------------------------------*/
\r
218 EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, const EventBits_t uxBitsToWaitFor, TickType_t xTicksToWait )
\r
220 EventBits_t uxOriginalBitValue, uxReturn;
\r
221 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
222 BaseType_t xAlreadyYielded;
\r
223 BaseType_t xTimeoutOccurred = pdFALSE;
\r
225 configASSERT( ( uxBitsToWaitFor & eventEVENT_BITS_CONTROL_BYTES ) == 0 );
\r
226 configASSERT( uxBitsToWaitFor != 0 );
\r
227 #if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) )
\r
229 configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) );
\r
235 uxOriginalBitValue = pxEventBits->uxEventBits;
\r
237 ( void ) xEventGroupSetBits( xEventGroup, uxBitsToSet );
\r
239 if( ( ( uxOriginalBitValue | uxBitsToSet ) & uxBitsToWaitFor ) == uxBitsToWaitFor )
\r
241 /* All the rendezvous bits are now set - no need to block. */
\r
242 uxReturn = ( uxOriginalBitValue | uxBitsToSet );
\r
244 /* Rendezvous always clear the bits. They will have been cleared
\r
245 already unless this is the only task in the rendezvous. */
\r
246 pxEventBits->uxEventBits &= ~uxBitsToWaitFor;
\r
252 if( xTicksToWait != ( TickType_t ) 0 )
\r
254 traceEVENT_GROUP_SYNC_BLOCK( xEventGroup, uxBitsToSet, uxBitsToWaitFor );
\r
256 /* Store the bits that the calling task is waiting for in the
\r
257 task's event list item so the kernel knows when a match is
\r
258 found. Then enter the blocked state. */
\r
259 vTaskPlaceOnUnorderedEventList( &( pxEventBits->xTasksWaitingForBits ), ( uxBitsToWaitFor | eventCLEAR_EVENTS_ON_EXIT_BIT | eventWAIT_FOR_ALL_BITS ), xTicksToWait );
\r
261 /* This assignment is obsolete as uxReturn will get set after
\r
262 the task unblocks, but some compilers mistakenly generate a
\r
263 warning about uxReturn being returned without being set if the
\r
264 assignment is omitted. */
\r
269 /* The rendezvous bits were not set, but no block time was
\r
270 specified - just return the current event bit value. */
\r
271 uxReturn = pxEventBits->uxEventBits;
\r
275 xAlreadyYielded = xTaskResumeAll();
\r
277 if( xTicksToWait != ( TickType_t ) 0 )
\r
279 if( xAlreadyYielded == pdFALSE )
\r
281 portYIELD_WITHIN_API();
\r
285 mtCOVERAGE_TEST_MARKER();
\r
288 /* The task blocked to wait for its required bits to be set - at this
\r
289 point either the required bits were set or the block time expired. If
\r
290 the required bits were set they will have been stored in the task's
\r
291 event list item, and they should now be retrieved then cleared. */
\r
292 uxReturn = uxTaskResetEventItemValue();
\r
294 if( ( uxReturn & eventUNBLOCKED_DUE_TO_BIT_SET ) == ( EventBits_t ) 0 )
\r
296 /* The task timed out, just return the current event bit value. */
\r
297 taskENTER_CRITICAL();
\r
299 uxReturn = pxEventBits->uxEventBits;
\r
301 /* Although the task got here because it timed out before the
\r
302 bits it was waiting for were set, it is possible that since it
\r
303 unblocked another task has set the bits. If this is the case
\r
304 then it needs to clear the bits before exiting. */
\r
305 if( ( uxReturn & uxBitsToWaitFor ) == uxBitsToWaitFor )
\r
307 pxEventBits->uxEventBits &= ~uxBitsToWaitFor;
\r
311 mtCOVERAGE_TEST_MARKER();
\r
314 taskEXIT_CRITICAL();
\r
316 xTimeoutOccurred = pdTRUE;
\r
320 /* The task unblocked because the bits were set. */
\r
323 /* Control bits might be set as the task had blocked should not be
\r
325 uxReturn &= ~eventEVENT_BITS_CONTROL_BYTES;
\r
328 traceEVENT_GROUP_SYNC_END( xEventGroup, uxBitsToSet, uxBitsToWaitFor, xTimeoutOccurred );
\r
332 /*-----------------------------------------------------------*/
\r
334 EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToWaitFor, const BaseType_t xClearOnExit, const BaseType_t xWaitForAllBits, TickType_t xTicksToWait )
\r
336 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
337 EventBits_t uxReturn, uxControlBits = 0;
\r
338 BaseType_t xWaitConditionMet, xAlreadyYielded;
\r
339 BaseType_t xTimeoutOccurred = pdFALSE;
\r
341 /* Check the user is not attempting to wait on the bits used by the kernel
\r
342 itself, and that at least one bit is being requested. */
\r
343 configASSERT( xEventGroup );
\r
344 configASSERT( ( uxBitsToWaitFor & eventEVENT_BITS_CONTROL_BYTES ) == 0 );
\r
345 configASSERT( uxBitsToWaitFor != 0 );
\r
346 #if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) )
\r
348 configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) );
\r
354 const EventBits_t uxCurrentEventBits = pxEventBits->uxEventBits;
\r
356 /* Check to see if the wait condition is already met or not. */
\r
357 xWaitConditionMet = prvTestWaitCondition( uxCurrentEventBits, uxBitsToWaitFor, xWaitForAllBits );
\r
359 if( xWaitConditionMet != pdFALSE )
\r
361 /* The wait condition has already been met so there is no need to
\r
363 uxReturn = uxCurrentEventBits;
\r
364 xTicksToWait = ( TickType_t ) 0;
\r
366 /* Clear the wait bits if requested to do so. */
\r
367 if( xClearOnExit != pdFALSE )
\r
369 pxEventBits->uxEventBits &= ~uxBitsToWaitFor;
\r
373 mtCOVERAGE_TEST_MARKER();
\r
376 else if( xTicksToWait == ( TickType_t ) 0 )
\r
378 /* The wait condition has not been met, but no block time was
\r
379 specified, so just return the current value. */
\r
380 uxReturn = uxCurrentEventBits;
\r
384 /* The task is going to block to wait for its required bits to be
\r
385 set. uxControlBits are used to remember the specified behaviour of
\r
386 this call to xEventGroupWaitBits() - for use when the event bits
\r
387 unblock the task. */
\r
388 if( xClearOnExit != pdFALSE )
\r
390 uxControlBits |= eventCLEAR_EVENTS_ON_EXIT_BIT;
\r
394 mtCOVERAGE_TEST_MARKER();
\r
397 if( xWaitForAllBits != pdFALSE )
\r
399 uxControlBits |= eventWAIT_FOR_ALL_BITS;
\r
403 mtCOVERAGE_TEST_MARKER();
\r
406 /* Store the bits that the calling task is waiting for in the
\r
407 task's event list item so the kernel knows when a match is
\r
408 found. Then enter the blocked state. */
\r
409 vTaskPlaceOnUnorderedEventList( &( pxEventBits->xTasksWaitingForBits ), ( uxBitsToWaitFor | uxControlBits ), xTicksToWait );
\r
411 /* This is obsolete as it will get set after the task unblocks, but
\r
412 some compilers mistakenly generate a warning about the variable
\r
413 being returned without being set if it is not done. */
\r
416 traceEVENT_GROUP_WAIT_BITS_BLOCK( xEventGroup, uxBitsToWaitFor );
\r
419 xAlreadyYielded = xTaskResumeAll();
\r
421 if( xTicksToWait != ( TickType_t ) 0 )
\r
423 if( xAlreadyYielded == pdFALSE )
\r
425 portYIELD_WITHIN_API();
\r
429 mtCOVERAGE_TEST_MARKER();
\r
432 /* The task blocked to wait for its required bits to be set - at this
\r
433 point either the required bits were set or the block time expired. If
\r
434 the required bits were set they will have been stored in the task's
\r
435 event list item, and they should now be retrieved then cleared. */
\r
436 uxReturn = uxTaskResetEventItemValue();
\r
438 if( ( uxReturn & eventUNBLOCKED_DUE_TO_BIT_SET ) == ( EventBits_t ) 0 )
\r
440 taskENTER_CRITICAL();
\r
442 /* The task timed out, just return the current event bit value. */
\r
443 uxReturn = pxEventBits->uxEventBits;
\r
445 /* It is possible that the event bits were updated between this
\r
446 task leaving the Blocked state and running again. */
\r
447 if( prvTestWaitCondition( uxReturn, uxBitsToWaitFor, xWaitForAllBits ) != pdFALSE )
\r
449 if( xClearOnExit != pdFALSE )
\r
451 pxEventBits->uxEventBits &= ~uxBitsToWaitFor;
\r
455 mtCOVERAGE_TEST_MARKER();
\r
460 mtCOVERAGE_TEST_MARKER();
\r
463 taskEXIT_CRITICAL();
\r
465 /* Prevent compiler warnings when trace macros are not used. */
\r
466 xTimeoutOccurred = pdFALSE;
\r
470 /* The task unblocked because the bits were set. */
\r
473 /* The task blocked so control bits may have been set. */
\r
474 uxReturn &= ~eventEVENT_BITS_CONTROL_BYTES;
\r
476 traceEVENT_GROUP_WAIT_BITS_END( xEventGroup, uxBitsToWaitFor, xTimeoutOccurred );
\r
480 /*-----------------------------------------------------------*/
\r
482 EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear )
\r
484 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
485 EventBits_t uxReturn;
\r
487 /* Check the user is not attempting to clear the bits used by the kernel
\r
489 configASSERT( xEventGroup );
\r
490 configASSERT( ( uxBitsToClear & eventEVENT_BITS_CONTROL_BYTES ) == 0 );
\r
492 taskENTER_CRITICAL();
\r
494 traceEVENT_GROUP_CLEAR_BITS( xEventGroup, uxBitsToClear );
\r
496 /* The value returned is the event group value prior to the bits being
\r
498 uxReturn = pxEventBits->uxEventBits;
\r
500 /* Clear the bits. */
\r
501 pxEventBits->uxEventBits &= ~uxBitsToClear;
\r
503 taskEXIT_CRITICAL();
\r
507 /*-----------------------------------------------------------*/
\r
509 #if ( ( configUSE_TRACE_FACILITY == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 1 ) )
\r
511 BaseType_t xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear )
\r
513 BaseType_t xReturn;
\r
515 traceEVENT_GROUP_CLEAR_BITS_FROM_ISR( xEventGroup, uxBitsToClear );
\r
516 xReturn = xTimerPendFunctionCallFromISR( vEventGroupClearBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToClear, NULL );
\r
522 /*-----------------------------------------------------------*/
\r
524 EventBits_t xEventGroupGetBitsFromISR( EventGroupHandle_t xEventGroup )
\r
526 UBaseType_t uxSavedInterruptStatus;
\r
527 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
528 EventBits_t uxReturn;
\r
530 uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();
\r
532 uxReturn = pxEventBits->uxEventBits;
\r
534 portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
\r
538 /*-----------------------------------------------------------*/
\r
540 EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet )
\r
542 ListItem_t *pxListItem, *pxNext;
\r
543 ListItem_t const *pxListEnd;
\r
545 EventBits_t uxBitsToClear = 0, uxBitsWaitedFor, uxControlBits;
\r
546 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
547 BaseType_t xMatchFound = pdFALSE;
\r
549 /* Check the user is not attempting to set the bits used by the kernel
\r
551 configASSERT( xEventGroup );
\r
552 configASSERT( ( uxBitsToSet & eventEVENT_BITS_CONTROL_BYTES ) == 0 );
\r
554 pxList = &( pxEventBits->xTasksWaitingForBits );
\r
555 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
558 traceEVENT_GROUP_SET_BITS( xEventGroup, uxBitsToSet );
\r
560 pxListItem = listGET_HEAD_ENTRY( pxList );
\r
562 /* Set the bits. */
\r
563 pxEventBits->uxEventBits |= uxBitsToSet;
\r
565 /* See if the new bit value should unblock any tasks. */
\r
566 while( pxListItem != pxListEnd )
\r
568 pxNext = listGET_NEXT( pxListItem );
\r
569 uxBitsWaitedFor = listGET_LIST_ITEM_VALUE( pxListItem );
\r
570 xMatchFound = pdFALSE;
\r
572 /* Split the bits waited for from the control bits. */
\r
573 uxControlBits = uxBitsWaitedFor & eventEVENT_BITS_CONTROL_BYTES;
\r
574 uxBitsWaitedFor &= ~eventEVENT_BITS_CONTROL_BYTES;
\r
576 if( ( uxControlBits & eventWAIT_FOR_ALL_BITS ) == ( EventBits_t ) 0 )
\r
578 /* Just looking for single bit being set. */
\r
579 if( ( uxBitsWaitedFor & pxEventBits->uxEventBits ) != ( EventBits_t ) 0 )
\r
581 xMatchFound = pdTRUE;
\r
585 mtCOVERAGE_TEST_MARKER();
\r
588 else if( ( uxBitsWaitedFor & pxEventBits->uxEventBits ) == uxBitsWaitedFor )
\r
590 /* All bits are set. */
\r
591 xMatchFound = pdTRUE;
\r
595 /* Need all bits to be set, but not all the bits were set. */
\r
598 if( xMatchFound != pdFALSE )
\r
600 /* The bits match. Should the bits be cleared on exit? */
\r
601 if( ( uxControlBits & eventCLEAR_EVENTS_ON_EXIT_BIT ) != ( EventBits_t ) 0 )
\r
603 uxBitsToClear |= uxBitsWaitedFor;
\r
607 mtCOVERAGE_TEST_MARKER();
\r
610 /* Store the actual event flag value in the task's event list
\r
611 item before removing the task from the event list. The
\r
612 eventUNBLOCKED_DUE_TO_BIT_SET bit is set so the task knows
\r
613 that is was unblocked due to its required bits matching, rather
\r
614 than because it timed out. */
\r
615 vTaskRemoveFromUnorderedEventList( pxListItem, pxEventBits->uxEventBits | eventUNBLOCKED_DUE_TO_BIT_SET );
\r
618 /* Move onto the next list item. Note pxListItem->pxNext is not
\r
619 used here as the list item may have been removed from the event list
\r
620 and inserted into the ready/pending reading list. */
\r
621 pxListItem = pxNext;
\r
624 /* Clear any bits that matched when the eventCLEAR_EVENTS_ON_EXIT_BIT
\r
625 bit was set in the control word. */
\r
626 pxEventBits->uxEventBits &= ~uxBitsToClear;
\r
628 ( void ) xTaskResumeAll();
\r
630 return pxEventBits->uxEventBits;
\r
632 /*-----------------------------------------------------------*/
\r
634 void vEventGroupDelete( EventGroupHandle_t xEventGroup )
\r
636 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
637 const List_t *pxTasksWaitingForBits = &( pxEventBits->xTasksWaitingForBits );
\r
641 traceEVENT_GROUP_DELETE( xEventGroup );
\r
643 while( listCURRENT_LIST_LENGTH( pxTasksWaitingForBits ) > ( UBaseType_t ) 0 )
\r
645 /* Unblock the task, returning 0 as the event list is being deleted
\r
646 and cannot therefore have any bits set. */
\r
647 configASSERT( pxTasksWaitingForBits->xListEnd.pxNext != ( const ListItem_t * ) &( pxTasksWaitingForBits->xListEnd ) );
\r
648 vTaskRemoveFromUnorderedEventList( pxTasksWaitingForBits->xListEnd.pxNext, eventUNBLOCKED_DUE_TO_BIT_SET );
\r
651 #if( ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 0 ) )
\r
653 /* The event group can only have been allocated dynamically - free
\r
655 vPortFree( pxEventBits );
\r
657 #elif( ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 1 ) )
\r
659 /* The event group could have been allocated statically or
\r
660 dynamically, so check before attempting to free the memory. */
\r
661 if( pxEventBits->ucStaticallyAllocated == ( uint8_t ) pdFALSE )
\r
663 vPortFree( pxEventBits );
\r
667 mtCOVERAGE_TEST_MARKER();
\r
670 #endif /* configSUPPORT_DYNAMIC_ALLOCATION */
\r
672 ( void ) xTaskResumeAll();
\r
674 /*-----------------------------------------------------------*/
\r
676 /* For internal use only - execute a 'set bits' command that was pended from
\r
678 void vEventGroupSetBitsCallback( void *pvEventGroup, const uint32_t ulBitsToSet )
\r
680 ( void ) xEventGroupSetBits( pvEventGroup, ( EventBits_t ) ulBitsToSet );
\r
682 /*-----------------------------------------------------------*/
\r
684 /* For internal use only - execute a 'clear bits' command that was pended from
\r
686 void vEventGroupClearBitsCallback( void *pvEventGroup, const uint32_t ulBitsToClear )
\r
688 ( void ) xEventGroupClearBits( pvEventGroup, ( EventBits_t ) ulBitsToClear );
\r
690 /*-----------------------------------------------------------*/
\r
692 static BaseType_t prvTestWaitCondition( const EventBits_t uxCurrentEventBits, const EventBits_t uxBitsToWaitFor, const BaseType_t xWaitForAllBits )
\r
694 BaseType_t xWaitConditionMet = pdFALSE;
\r
696 if( xWaitForAllBits == pdFALSE )
\r
698 /* Task only has to wait for one bit within uxBitsToWaitFor to be
\r
699 set. Is one already set? */
\r
700 if( ( uxCurrentEventBits & uxBitsToWaitFor ) != ( EventBits_t ) 0 )
\r
702 xWaitConditionMet = pdTRUE;
\r
706 mtCOVERAGE_TEST_MARKER();
\r
711 /* Task has to wait for all the bits in uxBitsToWaitFor to be set.
\r
712 Are they set already? */
\r
713 if( ( uxCurrentEventBits & uxBitsToWaitFor ) == uxBitsToWaitFor )
\r
715 xWaitConditionMet = pdTRUE;
\r
719 mtCOVERAGE_TEST_MARKER();
\r
723 return xWaitConditionMet;
\r
725 /*-----------------------------------------------------------*/
\r
727 #if ( ( configUSE_TRACE_FACILITY == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 1 ) )
\r
729 BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, BaseType_t *pxHigherPriorityTaskWoken )
\r
731 BaseType_t xReturn;
\r
733 traceEVENT_GROUP_SET_BITS_FROM_ISR( xEventGroup, uxBitsToSet );
\r
734 xReturn = xTimerPendFunctionCallFromISR( vEventGroupSetBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToSet, pxHigherPriorityTaskWoken );
\r
740 /*-----------------------------------------------------------*/
\r
742 #if (configUSE_TRACE_FACILITY == 1)
\r
744 UBaseType_t uxEventGroupGetNumber( void* xEventGroup )
\r
746 UBaseType_t xReturn;
\r
747 EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup;
\r
749 if( xEventGroup == NULL )
\r
755 xReturn = pxEventBits->uxEventGroupNumber;
\r