os_time.c
上传用户:yyyd609
上传日期:2022-07-18
资源大小:183k
文件大小:11k
源码类别:

微处理器开发

开发平台:

C/C++

  1. /*
  2. *********************************************************************************************************
  3. *                                                uC/OS-II
  4. *                                          The Real-Time Kernel
  5. *                                             TIME MANAGEMENT
  6. *
  7. *                          (c) Copyright 1992-2003, Jean J. Labrosse, Weston, FL
  8. *                                           All Rights Reserved
  9. *
  10. * File    : OS_TIME.C
  11. * By      : Jean J. Labrosse
  12. * Version : V2.76
  13. *********************************************************************************************************
  14. */
  15. #ifndef  OS_MASTER_FILE
  16. #include <ucos_ii.h>
  17. #endif
  18. /*
  19. *********************************************************************************************************
  20. *                                DELAY TASK 'n' TICKS   (n from 0 to 65535)
  21. *
  22. * Description: This function is called to delay execution of the currently running task until the
  23. *              specified number of system ticks expires.  This, of course, directly equates to delaying
  24. *              the current task for some time to expire.  No delay will result If the specified delay is
  25. *              0.  If the specified delay is greater than 0 then, a context switch will result.
  26. *
  27. * Arguments  : ticks     is the time delay that the task will be suspended in number of clock 'ticks'.
  28. *                        Note that by specifying 0, the task will not be delayed.
  29. *
  30. * Returns    : none
  31. *********************************************************************************************************
  32. */
  33. void  OSTimeDly (INT16U ticks)
  34. {
  35.     INT8U      y;
  36. #if OS_CRITICAL_METHOD == 3                      /* Allocate storage for CPU status register           */
  37.     OS_CPU_SR  cpu_sr;
  38.     cpu_sr = 0;                                  /* Prevent compiler warning                           */
  39. #endif    
  40.     if (ticks > 0) {                             /* 0 means no delay!                                  */
  41.         OS_ENTER_CRITICAL();
  42.         y            =  OSTCBCur->OSTCBY;        /* Delay current task                                 */
  43.         OSRdyTbl[y] &= ~OSTCBCur->OSTCBBitX;
  44.         if (OSRdyTbl[y] == 0) {  
  45.             OSRdyGrp &= ~OSTCBCur->OSTCBBitY;
  46.         }
  47.         OSTCBCur->OSTCBDly = ticks;              /* Load ticks in TCB                                  */
  48.         OS_EXIT_CRITICAL();
  49.         OS_Sched();                              /* Find next task to run!                             */
  50.     }
  51. }
  52. /*$PAGE*/
  53. /*
  54. *********************************************************************************************************
  55. *                                     DELAY TASK FOR SPECIFIED TIME
  56. *
  57. * Description: This function is called to delay execution of the currently running task until some time
  58. *              expires.  This call allows you to specify the delay time in HOURS, MINUTES, SECONDS and
  59. *              MILLISECONDS instead of ticks.
  60. *
  61. * Arguments  : hours     specifies the number of hours that the task will be delayed (max. is 255)
  62. *              minutes   specifies the number of minutes (max. 59)
  63. *              seconds   specifies the number of seconds (max. 59)
  64. *              milli     specifies the number of milliseconds (max. 999)
  65. *
  66. * Returns    : OS_NO_ERR
  67. *              OS_TIME_INVALID_MINUTES
  68. *              OS_TIME_INVALID_SECONDS
  69. *              OS_TIME_INVALID_MS
  70. *              OS_TIME_ZERO_DLY
  71. *
  72. * Note(s)    : The resolution on the milliseconds depends on the tick rate.  For example, you can't do
  73. *              a 10 mS delay if the ticker interrupts every 100 mS.  In this case, the delay would be
  74. *              set to 0.  The actual delay is rounded to the nearest tick.
  75. *********************************************************************************************************
  76. */
  77. #if OS_TIME_DLY_HMSM_EN > 0
  78. INT8U  OSTimeDlyHMSM (INT8U hours, INT8U minutes, INT8U seconds, INT16U milli)
  79. {
  80.     INT32U ticks;
  81.     INT16U loops;
  82. #if OS_ARG_CHK_EN > 0
  83.     if (hours == 0) {
  84.         if (minutes == 0) {
  85.             if (seconds == 0) {
  86.                 if (milli == 0) {
  87.                     return (OS_TIME_ZERO_DLY);
  88.                 }
  89.             }
  90.         }
  91.     }
  92.     if (minutes > 59) {
  93.         return (OS_TIME_INVALID_MINUTES);        /* Validate arguments to be within range              */
  94.     }
  95.     if (seconds > 59) {
  96.         return (OS_TIME_INVALID_SECONDS);
  97.     }
  98.     if (milli > 999) {
  99.         return (OS_TIME_INVALID_MILLI);
  100.     }
  101. #endif
  102.                                                  /* Compute the total number of clock ticks required.. */
  103.                                                  /* .. (rounded to the nearest tick)                   */
  104.     ticks = ((INT32U)hours * 3600L + (INT32U)minutes * 60L + (INT32U)seconds) * OS_TICKS_PER_SEC
  105.           + OS_TICKS_PER_SEC * ((INT32U)milli + 500L / OS_TICKS_PER_SEC) / 1000L;
  106.     loops = (INT16U)(ticks / 65536L);            /* Compute the integral number of 65536 tick delays   */
  107.     ticks = ticks % 65536L;                      /* Obtain  the fractional number of ticks             */
  108.     OSTimeDly((INT16U)ticks);
  109.     while (loops > 0) {
  110.         OSTimeDly((INT16U)32768u);
  111.         OSTimeDly((INT16U)32768u);
  112.         loops--;
  113.     }
  114.     return (OS_NO_ERR);
  115. }
  116. #endif
  117. /*$PAGE*/
  118. /*
  119. *********************************************************************************************************
  120. *                                         RESUME A DELAYED TASK
  121. *
  122. * Description: This function is used resume a task that has been delayed through a call to either
  123. *              OSTimeDly() or OSTimeDlyHMSM().  Note that you can call this function to resume a
  124. *              task that is waiting for an event with timeout.  This would make the task look
  125. *              like a timeout occurred.  
  126. *
  127. *              Also, you cannot resume a task that has called OSTimeDlyHMSM() with a combined time that 
  128. *              exceeds 65535 clock ticks.  In other words, if the clock tick runs at 100 Hz then, you will 
  129. *              not be able to resume a delayed task that called OSTimeDlyHMSM(0, 10, 55, 350) or higher:
  130. *
  131. *                  (10 Minutes * 60 + 55 Seconds + 0.35) * 100 ticks/second.
  132. *
  133. * Arguments  : prio                      specifies the priority of the task to resume
  134. *
  135. * Returns    : OS_NO_ERR                 Task has been resumed
  136. *              OS_PRIO_INVALID           if the priority you specify is higher that the maximum allowed
  137. *                                        (i.e. >= OS_LOWEST_PRIO)
  138. *              OS_TIME_NOT_DLY           Task is not waiting for time to expire
  139. *              OS_TASK_NOT_EXIST         The desired task has not been created or has been assigned to a Mutex.
  140. *********************************************************************************************************
  141. */
  142. #if OS_TIME_DLY_RESUME_EN > 0
  143. INT8U  OSTimeDlyResume (INT8U prio)
  144. {
  145.     OS_TCB    *ptcb;
  146. #if OS_CRITICAL_METHOD == 3                                    /* Storage for CPU status register      */
  147.     OS_CPU_SR  cpu_sr;
  148.     cpu_sr = 0;                                                /* Prevent compiler warning             */
  149. #endif    
  150.     if (prio >= OS_LOWEST_PRIO) {
  151.         return (OS_PRIO_INVALID);
  152.     }
  153.     OS_ENTER_CRITICAL();
  154.     ptcb = (OS_TCB *)OSTCBPrioTbl[prio];                       /* Make sure that task exist            */
  155.     if (ptcb == (OS_TCB *)0) {
  156.         OS_EXIT_CRITICAL();
  157.         return (OS_TASK_NOT_EXIST);                            /* The task does not exist              */
  158.     }
  159.     if (ptcb == (OS_TCB *)1) {
  160.         OS_EXIT_CRITICAL();
  161.         return (OS_TASK_NOT_EXIST);                            /* The task does not exist              */
  162.     }
  163.     if (ptcb->OSTCBDly == 0) {                                 /* See if task is delayed               */
  164.         OS_EXIT_CRITICAL();
  165.         return (OS_TIME_NOT_DLY);                              /* Indicate that task was not delayed   */
  166.     }
  167.     ptcb->OSTCBDly = 0;                                        /* Clear the time delay                 */
  168.     if ((ptcb->OSTCBStat & OS_STAT_PEND_ANY) != OS_STAT_RDY) {
  169.         ptcb->OSTCBStat   &= ~OS_STAT_PEND_ANY;                /* Yes, Clear status flag               */
  170.         ptcb->OSTCBPendTO  = TRUE;                             /* Indicate PEND timeout                */
  171.     } else {
  172.         ptcb->OSTCBPendTO  = FALSE;
  173.     }
  174.     if ((ptcb->OSTCBStat & OS_STAT_SUSPEND) == OS_STAT_RDY) {  /* Is task suspended?                   */
  175.         OSRdyGrp               |= ptcb->OSTCBBitY;             /* No,  Make ready                      */
  176.         OSRdyTbl[ptcb->OSTCBY] |= ptcb->OSTCBBitX;
  177.         OS_EXIT_CRITICAL();
  178.         OS_Sched();                                           /* See if this is new highest priority   */
  179.     } else {
  180.         OS_EXIT_CRITICAL();                                   /* Task may be suspended                 */
  181.     }
  182.     return (OS_NO_ERR);
  183. }
  184. #endif    
  185. /*$PAGE*/
  186. /*
  187. *********************************************************************************************************
  188. *                                         GET CURRENT SYSTEM TIME
  189. *
  190. * Description: This function is used by your application to obtain the current value of the 32-bit
  191. *              counter which keeps track of the number of clock ticks.
  192. *
  193. * Arguments  : none
  194. *
  195. * Returns    : The current value of OSTime
  196. *********************************************************************************************************
  197. */
  198. #if OS_TIME_GET_SET_EN > 0
  199. INT32U  OSTimeGet (void)
  200. {
  201.     INT32U     ticks;
  202. #if OS_CRITICAL_METHOD == 3                      /* Allocate storage for CPU status register           */
  203.     OS_CPU_SR  cpu_sr;
  204.     cpu_sr = 0;                                  /* Prevent compiler warning                           */
  205. #endif    
  206.     OS_ENTER_CRITICAL();
  207.     ticks = OSTime;
  208.     OS_EXIT_CRITICAL();
  209.     return (ticks);
  210. }
  211. #endif    
  212. /*
  213. *********************************************************************************************************
  214. *                                            SET SYSTEM CLOCK
  215. *
  216. * Description: This function sets the 32-bit counter which keeps track of the number of clock ticks.
  217. *
  218. * Arguments  : ticks      specifies the new value that OSTime needs to take.
  219. *
  220. * Returns    : none
  221. *********************************************************************************************************
  222. */
  223. #if OS_TIME_GET_SET_EN > 0
  224. void  OSTimeSet (INT32U ticks)
  225. {
  226. #if OS_CRITICAL_METHOD == 3                      /* Allocate storage for CPU status register           */
  227.     OS_CPU_SR  cpu_sr;
  228.     cpu_sr = 0;                                  /* Prevent compiler warning                           */
  229. #endif    
  230.     OS_ENTER_CRITICAL();
  231.     OSTime = ticks;
  232.     OS_EXIT_CRITICAL();
  233. }
  234. #endif