freertos-7.3.0/source/include/list.h File Reference

Data Structures
struct	xLIST
struct	xLIST_ITEM
struct	xMINI_LIST_ITEM

Macros
#define	listCURRENT_LIST_LENGTH(pxList)   ( ( pxList )->uxNumberOfItems )
#define	listGET_ITEM_VALUE_OF_HEAD_ENTRY(pxList)   ( (&( ( pxList )->xListEnd ))->pxNext->xItemValue )
#define	listGET_LIST_ITEM_OWNER(pxListItem)   ( pxListItem )->pvOwner
#define	listGET_LIST_ITEM_VALUE(pxListItem)   ( ( pxListItem )->xItemValue )
#define	listGET_OWNER_OF_HEAD_ENTRY(pxList)   ( (&( ( pxList )->xListEnd ))->pxNext->pvOwner )
#define	listGET_OWNER_OF_NEXT_ENTRY(pxTCB, pxList)
#define	listIS_CONTAINED_WITHIN(pxList, pxListItem)   ( ( pxListItem )->pvContainer == ( void * ) ( pxList ) )
#define	listLIST_IS_EMPTY(pxList)   ( ( pxList )->uxNumberOfItems == ( unsigned portBASE_TYPE ) 0 )
#define	listLIST_IS_INITIALISED(pxList)   ( ( pxList )->xListEnd.xItemValue == portMAX_DELAY )
#define	listLIST_ITEM_CONTAINER(pxListItem)   ( ( pxListItem )->pvContainer )
#define	listSET_LIST_ITEM_OWNER(pxListItem, pxOwner)   ( pxListItem )->pvOwner = ( void * ) ( pxOwner )
#define	listSET_LIST_ITEM_VALUE(pxListItem, xValue)   ( pxListItem )->xItemValue = ( xValue )

Typedefs
typedef struct xLIST	xList
typedef struct xLIST_ITEM	xListItem
typedef struct xMINI_LIST_ITEM	xMiniListItem

Functions
unsigned portBASE_TYPE	uxListRemove (xListItem *pxItemToRemove)
void	vListInitialise (xList *pxList)
void	vListInitialiseItem (xListItem *pxItem)
void	vListInsert (xList *pxList, xListItem *pxNewListItem)
void	vListInsertEnd (xList *pxList, xListItem *pxNewListItem)

#define listCURRENT_LIST_LENGTH

(

pxList

)

( ( pxList )->uxNumberOfItems )

Referenced by portTASK_FUNCTION(), vEventGroupDelete(), and xTaskIncrementTick().

#define listGET_ITEM_VALUE_OF_HEAD_ENTRY

(

pxList

)

( (&( ( pxList )->xListEnd ))->pxNext->xItemValue )

#define listGET_LIST_ITEM_OWNER

(

pxListItem

)

( pxListItem )->pvOwner

Referenced by vTaskRemoveFromUnorderedEventList(), and xTaskRemoveFromUnorderedEventList().

#define listGET_LIST_ITEM_VALUE

(

pxListItem

)

( ( pxListItem )->xItemValue )

Referenced by prvCheckDelayedList(), prvResetNextTaskUnblockTime(), uxTaskResetEventItemValue(), vTaskIncrementTick(), xEventGroupSetBits(), and xTaskIncrementTick().

#define listGET_OWNER_OF_HEAD_ENTRY

(

pxList

)

( (&( ( pxList )->xListEnd ))->pxNext->pvOwner )

Referenced by prvCheckDelayedList(), prvCheckPendingReadyList(), prvCheckTasksWaitingTermination(), prvResetNextTaskUnblockTime(), vTaskIncrementTick(), xCoRoutineRemoveFromEventList(), xTaskIncrementTick(), xTaskRemoveFromEventList(), and xTaskResumeAll().

#define listGET_OWNER_OF_NEXT_ENTRY	(		pxTCB,
			pxList
	)

Value:

{                                                                                       \
xList * const pxConstList = ( pxList );                                                 \
    /* Increment the index to the next item and return the item, ensuring */            \
    /* we don't return the marker used at the end of the list.  */                      \
    ( pxConstList )->pxIndex = ( pxConstList )->pxIndex->pxNext;                        \
	if( ( pxConstList )->pxIndex == ( xListItem * ) &( ( pxConstList )->xListEnd ) )   \
    {                                                                                   \
        ( pxConstList )->pxIndex = ( pxConstList )->pxIndex->pxNext;                    \
    }                                                                                   \
    ( pxTCB ) = ( pxConstList )->pxIndex->pvOwner;                                      \
}

Referenced by vCoRoutineSchedule(), and vTaskSwitchContext().

#define listIS_CONTAINED_WITHIN	(		pxList,
			pxListItem
	)		( ( pxListItem )->pvContainer == ( void * ) ( pxList ) )

#define listLIST_IS_EMPTY

(

pxList

)

( ( pxList )->uxNumberOfItems == ( unsigned portBASE_TYPE ) 0 )

Referenced by prvCheckDelayedList(), prvCheckPendingReadyList(), prvCheckTasksWaitingTermination(), prvResetNextTaskUnblockTime(), prvUnlockQueue(), vCoRoutineSchedule(), vTaskIncrementTick(), vTaskSwitchContext(), xQueueGenericReceive(), xQueueGenericReset(), xQueueGenericSend(), xQueueGenericSendFromISR(), xQueueGiveFromISR(), xQueuePeek(), xQueueReceive(), xQueueReceiveFromISR(), xQueueSemaphoreTake(), xTaskIncrementTick(), and xTaskResumeAll().

#define listLIST_IS_INITIALISED

(

pxList

)

( ( pxList )->xListEnd.xItemValue == portMAX_DELAY )

#define listLIST_ITEM_CONTAINER

(

pxListItem

)

( ( pxListItem )->pvContainer )

Referenced by xTaskIncrementTick().

#define listSET_LIST_ITEM_OWNER	(		pxListItem,
			pxOwner
	)		( pxListItem )->pvOwner = ( void * ) ( pxOwner )

Referenced by prvInitialiseTCBVariables(), and xCoRoutineCreate().

#define listSET_LIST_ITEM_VALUE	(		pxListItem,
			xValue
	)		( pxListItem )->xItemValue = ( xValue )

Referenced by prvAddCurrentTaskToDelayedList(), prvInitialiseTCBVariables(), uxTaskResetEventItemValue(), vCoRoutineAddToDelayedList(), vTaskPlaceOnUnorderedEventList(), vTaskRemoveFromUnorderedEventList(), xCoRoutineCreate(), and xTaskRemoveFromUnorderedEventList().

typedef struct xLIST xList

typedef struct xLIST_ITEM xListItem

typedef struct xMINI_LIST_ITEM xMiniListItem

unsigned portBASE_TYPE uxListRemove

(

xListItem *

pxItemToRemove

)

void vListInitialise

(

xList *

pxList

)

void vListInitialiseItem

(

xListItem *

pxItem

)

void vListInsert	(	xList *	pxList,
		xListItem *	pxNewListItem
	)

void vListInsertEnd	(	xList *	pxList,
		xListItem *	pxNewListItem
	)