OpenHarmony內(nèi)核編程接口—介紹定時(shí)器管理兩種定時(shí)器以及案例演示

作者：他們都叫我KAI 2023-08-02 09:26:03

軟件定時(shí)器(Timer)，是基于系統(tǒng)時(shí)鐘tick且由軟件來(lái)模擬的定時(shí)器，當(dāng)經(jīng)過設(shè)定的tick計(jì)數(shù)值后會(huì)觸發(fā)用戶定義的回調(diào)函數(shù)。

51CTO 開源基礎(chǔ)軟件社區(qū)

https://ost.51cto.com

前言

本文介紹了內(nèi)核編程接口之軟定時(shí)器

軟定時(shí)器

軟定時(shí)器含義

軟件定時(shí)器(Timer)，是基于系統(tǒng)時(shí)鐘tick且由軟件來(lái)模擬的定時(shí)器，當(dāng)經(jīng)過設(shè)定的tick計(jì)數(shù)值后會(huì)觸發(fā)用戶定義的回調(diào)函數(shù)。
ps1:定時(shí)器觸發(fā)函數(shù)的執(zhí)行，不是線程。
ps2:當(dāng)定時(shí)器到期時(shí)，將執(zhí)行回調(diào)函數(shù)以運(yùn)行特定的代碼。
ps3:定時(shí)精度與時(shí)鐘周期有關(guān)。
ps4:所有定時(shí)器都可以啟動(dòng)、重新啟動(dòng)或停止。
ps5:每個(gè)定時(shí)器都可以配置為一次性或周期性定時(shí)器。

一次性定時(shí)器

一次性定時(shí)器指僅執(zhí)行一次操作即停止，不會(huì)自動(dòng)重新啟動(dòng)。

【OpenHarmony內(nèi)核編程接口】介紹定時(shí)器管理兩種定時(shí)器以及案例演示-開源基礎(chǔ)軟件社區(qū)

周期性定時(shí)器

周期性定時(shí)器指重復(fù)其操作，直到它被刪除或停止。

【OpenHarmony內(nèi)核編程接口】介紹定時(shí)器管理兩種定時(shí)器以及案例演示-開源基礎(chǔ)軟件社區(qū)

API接口介紹

osTimerNew

功能：創(chuàng)建并初始化一個(gè)定時(shí)器。
定義：osTimerId_t osTimerNew (osTimerFunc_t func, osTimerType_t type, void *argument, const osTimerAttr_t *attr)。
參數(shù)：

func ：定時(shí)器回調(diào)函數(shù)。
type ：定時(shí)器類型。osTimerOnce 一次性定時(shí)器， osTimerPeriodic 周期性定時(shí)器。
argument ：定時(shí)器回調(diào)函數(shù)的參數(shù)。
attr ：定時(shí)器屬性。

返回值：成功返回定時(shí)器id，失敗返回 NULL。

osTimerGetName

功能：獲取指定ID的定時(shí)器的名稱
定義：const char *osTimerGetName(osTimerId_t timer_id)
參數(shù)：timer_id ：定時(shí)器 ID ，由 osTimerNew 生成
返回值：成功返回定時(shí)器的名稱，失敗返回 NULL

osTimerStart

功能：?jiǎn)?dòng)或者重啟指定ID的定時(shí)器
定義：osStatus_t osTimerStart(osTimerId_t timer_id, uint32_t ticks)
參數(shù)：imer_id ：定時(shí)器ID，由 osTimerNew 生成
ticks ：定時(shí)器的間隔
返回值：osOK ：操作成功
osErrorISR ：不能從中斷服務(wù)程序中調(diào)用
osErrorParameter ：參數(shù)錯(cuò)誤
osErrorResource ：定時(shí)器狀態(tài)無(wú)效

osTimerStop

功能：停止指定ID的定時(shí)器
定義：osStatus_t osTimerStop (osTimerId_t timer_id)
參數(shù)：timer_id ：定時(shí)器ID ，由 osTimerNew 生成
返回值：osOK ：操作成功
osErrorISR ：不能從中斷服務(wù)程序中調(diào)用
osErrorParameter ：參數(shù)錯(cuò)誤
osErrorResource ：定時(shí)器不在運(yùn)行狀態(tài)(只能停止運(yùn)行態(tài)的定時(shí)器)

osTimerIsRunning

功能：檢查指定ID的定時(shí)器是否在運(yùn)行
定義：uint32_t osTimerIsRunning (osTimerId_t timer_id)
參數(shù)：timer_id ：定時(shí)器ID，由 osTimerNew 生成
返回值：1 ：運(yùn)行 0 ：沒有運(yùn)行或發(fā)生錯(cuò)誤

osTimerDelete

功能：刪除指定ID的定時(shí)器
定義：osStatus_t osTimerDelete (osTimerId_t timer_id)
參數(shù)：timer_id ：定時(shí)器ID，由 osTimerNew 生成
返回值：osOK ：操作成功
osErrorISR ：不能從中斷服務(wù)程序中調(diào)用
osErrorParameter ：參數(shù)錯(cuò)誤
osErrorResource ：定時(shí)器狀態(tài)無(wú)效