OS_TIME.C
上传用户:zfj3589
上传日期:2022-07-13
资源大小:635k
文件大小:10k
源码类别:

微处理器开发

开发平台:

C/C++

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