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 > 0INT8U  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 > 0INT8U  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 > 0INT32U  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 > 0void  OSTimeSet (INT32U ticks){#if OS_CRITICAL_METHOD == 3                        OS_CPU_SR  cpu_sr;#endif        OS_ENTER_CRITICAL();    OSTime = ticks;    OS_EXIT_CRITICAL();}#endif