907-FreeRTOS202212‐ulTaskNotifyTake() 与 ulTaskNotifyTakeIndexed（）

weixin_43420126

于 2023-11-23 00:36:43 发布

阅读量95

点赞数

分类专栏： FreeRTOS 学习手记 09 - 直达任务通知文章标签： c语言

本文链接：https://blog.csdn.net/weixin_43420126/article/details/134566212

版权

FreeRTOS 学习手记 09 - 直达任务通知专栏收录该内容

10 篇文章 1 订阅

订阅专栏

#define ulTaskNotifyTake( xClearCountOnExit, xTicksToWait ) \
	ulTaskGenericNotifyTake( ( tskDEFAULT_INDEX_TO_NOTIFY ), ( xClearCountOnExit ), ( xTicksToWait ) )

#define ulTaskNotifyTakeIndexed( uxIndexToWaitOn, xClearCountOnExit, xTicksToWait ) \
    	ulTaskGenericNotifyTake( ( uxIndexToWaitOn ), ( xClearCountOnExit ), ( xTicksToWait ) )

/*---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------*/

#if ( configUSE_TASK_NOTIFICATIONS == 1 )

    	uint32_t ulTaskGenericNotifyTake( 	UBaseType_t 	uxIndexToWait,	/* 调用任务的数组中通知值的索引， 调用任务将在该通知值上等待通知 */
                                      	BaseType_t 	xClearCountOnExit,	/* pdTRUE：退出前清零任务通知值，类似二值信号量, pdFALSE:退出前任务通知值递减,类似递减计数信号量 */
                                      	TickType_t 	xTicksToWait )	/* 阻塞状态下等待接收通知的最长时间 */

    	{
        	uint32_t ulReturn;

        	configASSERT( uxIndexToWait < configTASK_NOTIFICATION_ARRAY_ENTRIES );

        	taskENTER_CRITICAL();
        	{
            		/* Only block if the notification count is not already non-zero. */
			/* 仅当通知值 为零时 阻塞任务 */
            		if( pxCurrentTCB->ulNotifiedValue[ uxIndexToWait ] == 0UL )
            		{
                		/* Mark this task as waiting for a notification. */
				/* 设置任务通知的状态为等待通知状态 */
                		pxCurrentTCB->ucNotifyState[ uxIndexToWait ] = taskWAITING_NOTIFICATION;

                		if( xTicksToWait > ( TickType_t ) 0 )
                		{
                    			prvAddCurrentTaskToDelayedList( xTicksToWait, pdTRUE );
                    			traceTASK_NOTIFY_TAKE_BLOCK( uxIndexToWait );

                    			/* All ports are written to allow a yield in a critical section (some will yield immediately, others wait until the critical section exits) - but it is not something that application code should ever do. */
					/*所有端口都被编写为允许在临界段中进行屈服（有些端口将立即屈服，另一些端口则等待关键部分退出），但这不是应用程序代码应该做的事情*/
                    			portYIELD_WITHIN_API();
                		}
                		else
                		{
                    			mtCOVERAGE_TEST_MARKER();
                		}
            		}
            		else
            		{
                		mtCOVERAGE_TEST_MARKER();
            		}
        	}
        	taskEXIT_CRITICAL();

        	taskENTER_CRITICAL();
        	{
            		traceTASK_NOTIFY_TAKE( uxIndexToWait );
            		ulReturn = pxCurrentTCB->ulNotifiedValue[ uxIndexToWait ];

            		if( ulReturn != 0UL )
            		{
                		if( xClearCountOnExit != pdFALSE )
                		{
                    			pxCurrentTCB->ulNotifiedValue[ uxIndexToWait ] = 0UL;
                		}
                		else
                		{
                    			pxCurrentTCB->ulNotifiedValue[ uxIndexToWait ] = ulReturn - ( uint32_t ) 1;
                		}
            		}
            		else
            		{
                		mtCOVERAGE_TEST_MARKER();
            		}

            		pxCurrentTCB->ucNotifyState[ uxIndexToWait ] = taskNOT_WAITING_NOTIFICATION;
        	}
        	taskEXIT_CRITICAL();

        	return ulReturn;
    	}

#endif /* configUSE_TASK_NOTIFICATIONS */
/*-----------------------------------------------------------*/