uC/OS-II源碼解析(os_time.c)

/*
** ver: 2.52
** file: os_time.c
** brief: 時間相關函數 C 文件
*/

#ifndef  OS_MASTER_FILE
#include "includes.h"                     /* 包含頭文件 */
#endif

/*
*********************************************************************************
*                                任務延時 'n' 時鐘節拍   (n : 0 - 65535)
*
* brief : 該函數用於將任務延時 ticks 個時鐘節拍後運行.
*
* ticks : 延時節拍數 <=65535
*
* note  : 如果任務至少需要延時1個時鐘節拍，必須調用 OSTimeDly(2)
*********************************************************************************
*/

void  OSTimeDly (INT16U ticks)
{
#if OS_CRITICAL_METHOD == 3                     
    OS_CPU_SR  cpu_sr;
#endif    


    if (ticks > 0) {                             /* 延時節拍數應大於0    */
        OS_ENTER_CRITICAL();
        if ((OSRdyTbl[OSTCBCur->OSTCBY] &= ~OSTCBCur->OSTCBBitX) == 0) {  
            OSRdyGrp &= ~OSTCBCur->OSTCBBitY;    /* 從就緒表中移除該任務 */
        }
        OSTCBCur->OSTCBDly = ticks;              /* 記錄ticks至TCB中     */
        OS_EXIT_CRITICAL();
        OS_Sched();                              /* 任務調度             */
    }
}
/*$PAGE*/
/*
********************************************************************************
*                                     按 h min sec ms 延時函數
*
* brief   : 該函數用於將任務按時分秒毫秒延時.
*
* hours   : 時   ( <=255)
* minutes : 分   ( <=59 )
* seconds : 秒   ( <=59 )
* milli   : 毫秒 ( <=999)
*
* returns    : OS_NO_ERR
*              OS_TIME_INVALID_MINUTES
*              OS_TIME_INVALID_SECONDS
*              OS_TIME_INVALID_MS
*              OS_TIME_ZERO_DLY
*
*********************************************************************************
*/

#if OS_TIME_DLY_HMSM_EN > 0
INT8U  OSTimeDlyHMSM (INT8U hours, INT8U minutes, INT8U seconds, INT16U milli)
{
    INT32U ticks;
    INT16U loops;


    if (hours > 0 || minutes > 0 || seconds > 0 || milli > 0) {
        if (minutes > 59) {
            return (OS_TIME_INVALID_MINUTES);    /* 無效的分鐘數         */
        }
        if (seconds > 59) {
            return (OS_TIME_INVALID_SECONDS);    /* 無效的秒參數         */
        }
        if (milli > 999) {
            return (OS_TIME_INVALID_MILLI);      /* 無效的毫秒數         */
        }

        /* 計算總的延時節拍數  */                                                           
        ticks = ((INT32U)hours * 3600L + (INT32U)minutes * 60L + (INT32U)seconds) 
        * OS_TICKS_PER_SEC 
        + OS_TICKS_PER_SEC * ((INT32U)milli + 500L / OS_TICKS_PER_SEC) / 1000L;
        loops = (INT16U)(ticks / 65536L);        /* 計算總節拍數包括多少個65536節拍   */
        ticks = ticks % 65536L;                  /* 剩餘節拍                          */
        OSTimeDly((INT16U)ticks);                /* 剩餘節拍延時                      */
        while (loops > 0) {                      /* 整數個65536節拍延時               */
            OSTimeDly(32768);
            OSTimeDly(32768);
            loops--;
        }
        return (OS_NO_ERR);
    }
    return (OS_TIME_ZERO_DLY);
}
#endif
/*$PAGE*/
/*
*******************************************************************************
*                                         恢復延時的任務
*
* breif: 該函數用於取消任務延時而進入就緒狀態，也可以喚醒正在等待事件的任務
*        ，但不推薦使用這種方法，在這種情況下，等待事件的任務會把它當做超時
*        處理，延時節拍超過65535的任務也不能通過該函數恢復
*
*        65535 = (10 Minutes * 60 + 55 Seconds + 0.35) * 100 ticks/second.
*
* prio : 任務優先級
*
* returns    : OS_NO_ERR                 成功
*              OS_PRIO_INVALID           無效的優先級
*              OS_TIME_NOT_DLY           任務無延時
*              OS_TASK_NOT_EXIST         任務不存在
*******************************************************************************
*/

#if OS_TIME_DLY_RESUME_EN > 0
INT8U  OSTimeDlyResume (INT8U prio)
{
#if OS_CRITICAL_METHOD == 3                     
    OS_CPU_SR  cpu_sr;
#endif    
    OS_TCB    *ptcb;


    if (prio >= OS_LOWEST_PRIO) {                      /* 無效的優先級    */
        return (OS_PRIO_INVALID);
    }
    OS_ENTER_CRITICAL();
    ptcb = (OS_TCB *)OSTCBPrioTbl[prio];               /* 獲取任務控制塊  */
    if (ptcb != (OS_TCB *)0) {
        if (ptcb->OSTCBDly != 0) {                     /* 任務必須有延時  */
            ptcb->OSTCBDly  = 0;                       /* 清零延時節拍數  */
            if ((ptcb->OSTCBStat & OS_STAT_SUSPEND) == OS_STAT_RDY) {  
                OSRdyGrp               |= ptcb->OSTCBBitY; /* 將任務置於就緒表中   */
                OSRdyTbl[ptcb->OSTCBY] |= ptcb->OSTCBBitX;
                OS_EXIT_CRITICAL();
                OS_Sched();                                /* 任務調度             */
            } else {
                OS_EXIT_CRITICAL();                        /* 任務被掛起           */
            }
            return (OS_NO_ERR);
        } else {
            OS_EXIT_CRITICAL();
            return (OS_TIME_NOT_DLY);                      /* 任務無延時           */
        }
    }
    OS_EXIT_CRITICAL();
    return (OS_TASK_NOT_EXIST);                            /* 任務不存在           */
}
#endif    
/*$PAGE*/
/*
*********************************************************************************
*                                         獲取當前系統時間
*
* brief    : 獲取當前系統時鐘節拍數
*
*
* Returns  : 當前 OSTime 值
**********************************************************************************
*/

#if OS_TIME_GET_SET_EN > 0
INT32U  OSTimeGet (void)
{
#if OS_CRITICAL_METHOD == 3                     
    OS_CPU_SR  cpu_sr;
#endif    
    INT32U     ticks;


    OS_ENTER_CRITICAL();
    ticks = OSTime;      /* 記錄系統時鐘節拍數 */
    OS_EXIT_CRITICAL();
    return (ticks);
}
#endif    

/*
********************************************************************************
*                                            設置系統時間
*
* brief : 該函數用於設置一個32位的時鐘節拍計數器
*
* ticks : 設置OSTime.
*
*********************************************************************************
*/

#if OS_TIME_GET_SET_EN > 0
void  OSTimeSet (INT32U ticks)
{
#if OS_CRITICAL_METHOD == 3                    
    OS_CPU_SR  cpu_sr;
#endif    


    OS_ENTER_CRITICAL();
    OSTime = ticks;
    OS_EXIT_CRITICAL();
}
#endif