OpenHarmony内核编程接口—介绍定时器管理两种定时器以及案例演示-51CTO.COM

前言

本文介绍了内核编程接口之软定时器

软定时器

软定时器含义

软件定时器(Timer)，是基于系统时钟tick且由软件来模拟的定时器，当经过设定的tick计数值后会触发用户定义的回调函数。
ps1:定时器触发函数的执行，不是线程。
ps2:当定时器到期时，将执行回调函数以运行特定的代码。
ps3:定时精度与时钟周期有关。
ps4:所有定时器都可以启动、重新启动或停止。
ps5:每个定时器都可以配置为一次性或周期性定时器。

一次性定时器

一次性定时器指仅执行一次操作即停止，不会自动重新启动。

【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区

周期性定时器

周期性定时器指重复其操作，直到它被删除或停止。

【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区

API接口介绍

osTimerNew

功能：创建并初始化一个定时器。
定义：osTimerId_t osTimerNew (osTimerFunc_t func, osTimerType_t type, void *argument, const osTimerAttr_t *attr)。
参数：

func ：定时器回调函数。
type ：定时器类型。osTimerOnce 一次性定时器， osTimerPeriodic 周期性定时器。
argument ：定时器回调函数的参数。
attr ：定时器属性。

返回值：成功返回定时器id，失败返回 NULL。

osTimerGetName

功能：获取指定ID的定时器的名称
定义：const char *osTimerGetName(osTimerId_t timer_id)
参数：timer_id ：定时器 ID ，由 osTimerNew 生成
返回值：成功返回定时器的名称，失败返回 NULL

osTimerStart

功能：启动或者重启指定ID的定时器
定义：osStatus_t osTimerStart(osTimerId_t timer_id, uint32_t ticks)
参数：imer_id ：定时器ID，由 osTimerNew 生成
ticks ：定时器的间隔
返回值：osOK ：操作成功
osErrorISR ：不能从中断服务程序中调用
osErrorParameter ：参数错误
osErrorResource ：定时器状态无效

osTimerStop

功能：停止指定ID的定时器
定义：osStatus_t osTimerStop (osTimerId_t timer_id)
参数：timer_id ：定时器ID ，由 osTimerNew 生成
返回值：osOK ：操作成功
osErrorISR ：不能从中断服务程序中调用
osErrorParameter ：参数错误
osErrorResource ：定时器不在运行状态(只能停止运行态的定时器)

osTimerIsRunning

功能：检查指定ID的定时器是否在运行
定义：uint32_t osTimerIsRunning (osTimerId_t timer_id)
参数：timer_id ：定时器ID，由 osTimerNew 生成
返回值：1 ：运行 0 ：没有运行或发生错误

osTimerDelete

功能：删除指定ID的定时器
定义：osStatus_t osTimerDelete (osTimerId_t timer_id)
参数：timer_id ：定时器ID，由 osTimerNew 生成
返回值：osOK ：操作成功
osErrorISR ：不能从中断服务程序中调用
osErrorParameter ：参数错误
osErrorResource ：定时器状态无效