FreeRTOS(V8.0.1)系统之vTaskDelay()和vTaskDelayUntil()

pengpengpang

#if ( INCLUDE_vTaskDelay == 1 )        //延时特定时间xTicksToDelay，这个时间需要转换为唤醒绝对时间xTimeToWake，        //这样才能在与vTaskIncrementTick函数中操作的数值是一致的xTicksToDelay:延时的节拍数        void vTaskDelay( const TickType_t xTicksToDelay )        {        TickType_t xTimeToWake;        BaseType_t xAlreadyYielded = pdFALSE;                if( xTicksToDelay > ( TickType_t ) 0U )//若延迟的时间是0，就是调度器的重新启动。若延时时间大于0，执行延时操作。                {                        configASSERT( uxSchedulerSuspended == 0 );                        vTaskSuspendAll();//系统维护一个uxSchedulerSuspended计数值，当其大于0时表示禁止调度；等于0时则表示允许调度。                        {                                traceTASK_DELAY();                                //计算唤醒时间--这可能会溢出，但不会有问题 ，大家会问为什么                //大家可以自己做个试验，两个uCHAR型数据相加，如果超过255，则等于多少？                                xTimeToWake = xTickCount + xTicksToDelay;//任务的唤醒时间更新。                                if( uxListRemove( &( pxCurrentTCB->xGenericListItem ) ) == ( UBaseType_t ) 0 )//若删除完后链表中没有任务                                //把任务从当前运行链表中移除出去，然后把它添加到阻塞链表里面                                {                                        //当前任务必须在就绪链表中，所以其是不必检查的，下面的宏定义可以直接调用                                        portRESET_READY_PRIORITY( pxCurrentTCB->uxPriority, uxTopReadyPriority );                                }                                else                                {                                        mtCOVERAGE_TEST_MARKER();                                }                                prvAddCurrentTaskToDelayedList( xTimeToWake );                                //prvAddCurrentTaskToDelayedList是一个函数，它是把当前的任务控制块，                                //放进DelayedList链表中，而DelayedList有两个链表，一个是溢出的，一个是正在应用的，                                //所以要根据传递进的参数xTimeToWake进行分别设置，如果是在当前的延时链表里就添加进现在的延时链表，                                //如果计算出来后是溢出链表，则添加进溢出链表里面                        }                        xAlreadyYielded = xTaskResumeAll();//得到任務切換的具體情況，pdTRUE切换成功否则切换失败。                }                else                {                        mtCOVERAGE_TEST_MARKER();                }                if( xAlreadyYielded == pdFALSE )//若上面的切换失败，或不需要延迟。直接进行切换。                {                        portYIELD_WITHIN_API();                        //实际就是终端控制及状态寄存器ICSR，写位28为1悬起PendSV，进入到xPortPendSVHandler。                }                else                {                        mtCOVERAGE_TEST_MARKER();                }        }#endif #if ( INCLUDE_vTaskDelayUntil == 1 )        void vTaskDelayUntil( TickType_t * const pxPreviousWakeTime, const TickType_t xTimeIncrement )//参数：pxPreviousWakeTime---上一次调用本函数的时间 //                xTimeIncrement---相对于pxPreviousWakeTime本次延时的节拍数//由于调用此函数的任务解除阻塞的时间是绝对时刻，比起相对于调用时刻的相对时间更精确(即比调用vTaskDelay()可以实现更精确的周期性)。//pxPreviousWakeTime: 此参数命名时假定vTaskDelayUntil()用于实现某个任务以固定频率周期性执行。这种情况下pxPreviousWakeTime//                                          保存了任务上一次离开阻塞态(被唤醒)的时刻。这个时刻被用作一个参考点来计算该任务下一次离开阻塞态的时刻。//xTimeIncrement: 此参数命名时同样是假定vTaskDelayUntil()用于实现某个任务以固定频率周期性执行 —— 这个频率就是由xTimeIncrement 指定的。 //                              *xTimeIncrement 的单位是心跳周期， 可以使用常量portTICK_RATE_MS 将毫秒转换为心跳周期        {        TickType_t xTimeToWake;//和vTaskDelay函数中一样定义，最终得到xTimeToWake赋值给xGenericListItem .xItemValue        BaseType_t xAlreadyYielded, xShouldDelay = pdFALSE;                configASSERT( pxPreviousWakeTime );                configASSERT( ( xTimeIncrement > 0U ) );                configASSERT( uxSchedulerSuspended == 0 );                vTaskSuspendAll();//调度器挂起                {                        const TickType_t xConstTickCount = xTickCount;//xTickCount在这个函数里面不能改变，所以采用另外一个变量做优化。                        xTimeToWake = *pxPreviousWakeTime + xTimeIncrement; //计算下次唤醒的时刻.                        if( xConstTickCount < *pxPreviousWakeTime )//说明 xTickCount 溢出了                        {                                //pxPreviousWakeTime指向上一次的唤醒时间，这个地方有点难理解，可以这样说明：时间轴是一个往前的轴，                                //是不会有溢出之说法，也就是说xTickCount永远都是大于唤醒时间的而不管哪一次的唤醒时间都是大于，                                //但由于溢出的存在，所以有时候xTickCount会小于唤醒时间，这里就说明是小于上一次设置的唤醒时间，如果是就说明是溢出了                                //::T3::::::T2:::::::::::::::::::::T1:::::::::::::::::::::::::::::::::::::T2:::::::::::::::::T3:::::::::*/                                //            xTickCount    *pxPreviousWakeTime                       xTickCount       xTimeToWake*/                                //T1对应*pxPreviousWakeTime ，T2对应xTickCount，T3对应xTimeToWake*/                                //因为在运行这个程序时，任务因为运行了其它程序，造成了xTickCount和唤醒时间不是在同一个点上，要么大于*pxPreviousWakeTime，                                //要么小于*pxPreviousWakeTime，就像T2一样，如果运行到T第一个T0处，那么，就相当于xTickCount已经溢出了，那么需要不                                //需要延时，就要看xTimeToWake所处的位置了，如果没溢出，则说明不需要延时就可以调度任务                                //，如果溢出了，还要看是否大于xTickCount，如果是才能算的上是真正的需要放入延时链表里面                                if( ( xTimeToWake < *pxPreviousWakeTime ) && ( xTimeToWake > xConstTickCount ) )                                //这时只有 xTimeToWake 也溢出了，并且 xTimeToWake > xConstTickCount 才需要休眠                                {                                        xShouldDelay = pdTRUE;                                }                                else                                {                                        mtCOVERAGE_TEST_MARKER();                                }                        }                        else                        {                                //下面两种情况才需要休眠                                if( ( xTimeToWake < *pxPreviousWakeTime ) || ( xTimeToWake > xConstTickCount ) )                                {                                        xShouldDelay = pdTRUE;                                }                                else                                {                                        mtCOVERAGE_TEST_MARKER();                                }                        }                        //为下一次 Delay 更新 pxPreviousWakeTime.                        *pxPreviousWakeTime = xTimeToWake;//把需要唤醒的绝对时间保存起来，保存到pxPreviousWakeTime指针变量里面                        if( xShouldDelay != pdFALSE )//这时需要休眠,由上面的判断任务是否进入延时链表，如果不需要，则仍是当前运行的任务                        {                                traceTASK_DELAY_UNTIL();                                //从 Ready 链表中删除，加入 Blocked List                                if( uxListRemove( &( pxCurrentTCB->xGenericListItem ) ) == ( UBaseType_t ) 0 )                                {                                        portRESET_READY_PRIORITY( pxCurrentTCB->uxPriority, uxTopReadyPriority );                                }                                else                                {                                        mtCOVERAGE_TEST_MARKER();                                }                                prvAddCurrentTaskToDelayedList( xTimeToWake );                        }                        else                        {                                mtCOVERAGE_TEST_MARKER();                        }                }                xAlreadyYielded = xTaskResumeAll();                //在运行上面临界区的程序时，可能有任务需要调度，但因为调度器的挂起而没有被调度，只是给出了登记，                //而这个xTaskResumeAll函数就是要把放进xPendingReadyList链表中的任务节点转移到真正的就绪链表pxReadyTasksLists里面，                //如果任务是因为tick缺失或者因为在恢复实际走过的滴答数时有任务需要抢占CPU，则 xAlreadyYielded 都为真，                //从而导致下面不会运行，如果没有被抢占也就是说当前还是处于最高级任务，但是上面的延时已经使其阻塞，从而在下面发生抢占                if( xAlreadyYielded == pdFALSE )                //强制自己交出CPU，使自身进入等待延时。个人认为：此处并不需要强制交出，如果上面并不需要加入延时链表，                //表示还是运行的当前任务，如果这个任务仍然是最高级的，则并不需要切换                {                        portYIELD_WITHIN_API();                }                else                {                        mtCOVERAGE_TEST_MARKER();                }        }#endif