FreeRTOS(V8.0.1)系统之vTaskSuspendAll()和xTaskResumeAll()

//如果一个临界区太长而不适合简单地关中断来实现，可以考虑采用挂起调度器的方式。但是唤醒(resuming, or un-suspending)调度器却是一个
//相对较长的操作。所以评估哪种是最佳方式需要结合实际情况。如果某个中断在调度器挂起过程中要求进行上下文切换，则个这请求也会被
//挂起，直到调度器被唤醒后才会得到执行
void vTaskSuspendAll( void )
{
//通过挂起调度器来创建临界区,挂起调度器有些时候也被称为锁定调度器
++uxSchedulerSuspended;//系统维护一个uxSchedulerSuspended计数值，当其大于0时表示禁止调度；等于0时则表示允许调度。
//返回值 在调度器挂起过程中，上下文切换请求也会被挂起，直到调度器被唤醒后才会得到执行。
//如果一个挂起的上下文切换请求在xTaskResumeAll()返回前得到执行，则函数返回pdTRUE，表示CPU要求被抢占，
//在其它情况下，xTaskResumeAll()返回pdFALSE，然后根据返回值，强制使任务交出CPU（或者叫做任务切换）
}

//如果一个临界区太长而不适合简单地关中断来实现，可以考虑采用挂起调度器的方式。但是唤醒(resuming, or un-suspending)调度器却是一个
//相对较长的操作。所以评估哪种是最佳方式需要结合实际情况。如果某个中断在调度器挂起过程中要求进行上下文切换，则个这请求也会被
//挂起，直到调度器被唤醒后才会得到执行
BaseType_t xTaskResumeAll ( void )
{
TCB_t *pxTCB;
BaseType_t xAlreadyYielded = pdFALSE;
//在禁止调度任务期间，若ISR导致了一个任务的就绪，这个任务就会放到xPendingReadyList中，
//一旦调度允许，必须把所有xPendingReadyList中的任务移动到一个合适的就绪链表中。
//要考虑调度器被挂起时，放在xPendingReadyList链表中的任务
taskENTER_CRITICAL();//关中断，进入临界区
{
--uxSchedulerSuspended;//调度器挂起计数器减一操作，如果仍大于0，则不止一个任务使调度器挂起;直到调度器不再挂起，则进入以下操作
if( uxSchedulerSuspended == ( UBaseType_t ) pdFALSE )
{
if( uxCurrentNumberOfTasks > ( UBaseType_t ) 0U )
{
//目前正在运行的任务数是否大于0，如果大于0，则进入以下操作，否则跳出本函数
//移除所有的被调度器挂起时就绪的任务，进入合适的就绪链表，直到xPendingReadyList链表为空
while( listLIST_IS_EMPTY( &xPendingReadyList ) == pdFALSE )
{
pxTCB = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( ( &xPendingReadyList ) );
( void ) uxListRemove( &( pxTCB->xEventListItem ) );
( void ) uxListRemove( &( pxTCB->xGenericListItem ) );
prvAddTaskToReadyList( pxTCB );
//我们转移的任务是否有比当前任务的优先级高的，如果有，则抢占申请成功，进行任务切换
if( pxTCB->uxPriority >= pxCurrentTCB->uxPriority )//新获取任务的优先级不低于当前任务的优先级
{
xYieldPending = pdTRUE;//任务切换被使能
}
else
{
mtCOVERAGE_TEST_MARKER();
}
}
//在调度器被挂起的时间之内，是否有丢失未处理的滴答数。uxMissedTicks是丢失的滴答数
if( uxPendedTicks > ( UBaseType_t ) 0U )//若在任务挂起了则其值的改变在心跳时钟中++。若大于0说明有丢失的时钟数。
{
while( uxPendedTicks > ( UBaseType_t ) 0U )
{
if( xTaskIncrementTick() != pdFALSE ) //模拟进入心跳时钟中断，若!pdFALSE则说明进行任务切换。即：补齐缺失的滴答数。
{
xYieldPending = pdTRUE;//允许任务切换
}
else
{
mtCOVERAGE_TEST_MARKER();
}
--uxPendedTicks;//将丢失的时钟数--，保证其准确性。
}
}
else
{
mtCOVERAGE_TEST_MARKER();
}

if( xYieldPending == pdTRUE )//若允许任务切换
{
#if( configUSE_PREEMPTION != 0 )//若使用抢占式的系统
{
xAlreadyYielded = pdTRUE;//返回值设为已经切换成功
}
#endif
taskYIELD_IF_USING_PREEMPTION();//启用抢占式的方式进行任务切换
}
else
{
mtCOVERAGE_TEST_MARKER();
}
}
}
else
{
mtCOVERAGE_TEST_MARKER();
}
}
taskEXIT_CRITICAL();

return xAlreadyYielded;//返回任务是否已经切换；已经切换返回pdTRUE；反之返回pdFALSE。
}