定時器的概念

定時器用于根據系統時啟動特定的函數，執行相應的任務。FreeRTOS的定時器可以配置啟動一次或者間隔一定時間執行。

當然，定時器的實現是基于RTOS心跳機制與任務列表的。這意味著其API可以任何RTOS托管下的程序段調用（而中斷不行），包括定時器關聯的的回調函數。

FreeRTOS提供了間隔執行定時器的運行時序:

API Description ※ 定時器不能在中斷中使用

**①****創建定時器 **osTimerNew()

定時器的類型分為單次(One-time )和多次執行(periodic),在創建時進行配置；其中多次執行時序見上圖；單次喚起一次后自動停止，需要用戶手動再次啟動。而多次執行則間隔指定時間就會執行一次，直至用戶停止。

osTimerId_t osTimerNew (osTimerFunc_t func, osTimerType_t type, void *argument, const osTimerAttr_t *attr);/*
創建一個定時器，并綁定相應的回調函數      @retval 定時器的ID;  創建失敗返回NULL
@param    void(* osTimerFunc_t)(void *argument) //這是回調函數的格式，例:
            -void Timer1_Callback(void *arg); //arg contains various type of variables.
func        -回調函數的地址，即函數名
type        -定時器類型(單次或間隔型):  osTimerOnce -執行單次  osTimerPeriodic -多次執行
*argument   -傳遞給回調函數的參數;傳入地址;缺省填 (void*)0即可
*/

②啟動定時器 osTimerStart()

osStatus_t osTimerStart (osTimerId_t timer_id, uint32_t ticks);/*
啟動定時器并指定時間間隔.  指定的回調函數在經過本函數指定的ticks后第一次被調用。
@param:
id           -定時器ID
ticks        -間隔時間 (單位心跳數)       
@retval:
osOK         -成功
osErrorISR   -在中斷中調用而出錯
osErrorParameter: parameter timer_id is either NULL or invalid or ticks is incorrect.
osErrorResource: the timer is in an invalid state.
*/

③停止定時器 osTimerStop()

停止定時器的效果從下一次喚醒開始(回調函數停止自己定時器的情況)

osStatus_t osTimerStop (osTimerId_t timer_id);/*
停止指定的定時器
@retval
osOK
osErrorISR
osErrorParameter: parameter timer_id is either NULL or invalid.
osErrorResource: the timer is not running (you can only stop a running timer).
*/

④查詢定時器啟動狀態osTimerIsRunning()

uint32_t osTimerIsRunning (osTimerId_t  timer_id);/*
@retval
0 U   -未啟動、中斷中調用、未創建
!0    -已啟動
*/

⑤刪除定時器 osTimerDelete()

回調函數可以刪除調用自己的定時器。

刪除后定時器id值變為NULL,可以再調用 osTimerNew() 為其創建新的定時器

osStatus_t osTimerDelete (osTimerId_t timer_id);/*
刪除定時器并清理其資源。
@retval: 
  osOK: the specified timer has been deleted.
  osErrorISR: osTimerDelete cannot be called from interrupt service routines.
  osErrorParameter: parameter timer_id is either NULL or invalid.
  osErrorResource: the timer is in an invalid state.
*/

示例

void Timer_Callback (void *arg);                // prototype for timer callback function
uint32_t exec;                                  // argument for the timer call back function
void TimerStop_example (void) {
  osTimerId_t id;                               // timer id
  osStatus_t  status;                           // function return status
  // Create periodic timer
  exec = 1U;
  id = osTimerNew(Timer_Callback, osTimerPeriodic, &exec, NULL);
  osTimerStart(id, 1000U);                      // start timer
  :
  status = osTimerStop(id);                     // stop timer
  if (status != osOK) {
    // Timer could not be stopped
  }
  ;
  osTimerStart(id, 1000U);                      // start timer again
  ;
}