定時器(Timer) 是一個使用內核系統時鐘來計時的內核對象。當一個定時器指定的時間計時結束,它將執行一個應用層面已定義的行爲,或簡單地記錄下這個“期滿”事件,並等待應用層讀取該狀態。
概念
zerphyr 定時器有兩種: 一次性定時器和週期性定時器。
每個定時器有以下關鍵屬性:
- 時限(Duration) 是指從啓動到定時器第一次期滿之間的時間間隔,單位爲毫秒。該值必須大於0。
- 週期(Period) 是指在定時器第一次期滿之後,後續每次期滿之間的時間間隔,單位爲毫秒。該值不能爲負數,若該值爲0,則該定時器爲一次性計時,並會在單次期滿後停止工作。
- 期滿函數(Expiry function) 是在定時器每次期滿時所執行的函數,該函數由系統時鐘中斷處理函數來執行。若在期滿時無函數需要執行,則該期滿函數需要指定爲
NULL
。 - 終止函數(Stop function) 是在定時器運行期間提前終止時所執行的函數。該函數由終止定時器的線程來執行。若在提前終止時無函數需要執行,則該終止函數需要指定爲
NULL
。 - 狀態值(status) 指示了自最後一次讀取該狀態值後,定時器經歷了多少次期滿。
定時器在使用前必須先初始化。初始化時將設置期滿函數和終止函數,清零定時器狀態值,並設置定時器爲 停止 狀態。
實現
定義一個定時器
通過使用類型爲 struct k_timer
的變量來定義一個定時器。 該定時器隨後必須通過調用 k_timer_init()
來初始化。
如下的代碼定義並初始化了一個定時器:
struct k_timer my_timer;
void my_expiry_function(struct k_timer *timer_id) {/* do some work here */};
k_timer_init(&my_timer, my_expiry_function, NULL);
或者,定時器可以在編譯階段通過調用 K_TIMER_DEFINE
來定義和初始化。如下的代碼與上面的代碼效果一致。
K_TIMER_DEFINE(my_timer, my_expiry_function, NULL);
啓動定時器
k_timer_start(&my_timer, K_SECONDS(1), K_SECONDS(1));
關於duration和period的個人理解
duration爲第一次定時器的超時時間,若period不爲0,往後定時器是一個週期性定時器,超時時間爲period的值。若period爲0,則爲一次性定時器,超時時間爲duration。duration只用於第一次超時時間。
其他
系統ticks獲得:
k_cycle_get_32()
當系統時鐘爲32MHz時,1s = 32000000 ticks