前言
本文介绍了内核编程接口之软定时器
软定时器
软定时器含义
软件定时器(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 ：定时器状态无效
案例演示
目标1：创建一个定时器，每 1 秒调用一次回调函数，回调函数给全局变量 times+1，主线程等待 3 秒，停止并删除定时器。
准备开发套件。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
根据路径，新建文件。
applications\sample\wifi-iot\app\timer_demo\timer.c。
applications\sample\wifi-iot\app\timer_demo\BUILD.gn。
编写源文件。
必要的头文件。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
定义全局变量和定时器回调函数。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
创建主线程函数。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
定义入口函数，运行入口函数。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
编写编译脚本，注意路径。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
编译成功。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
烧录成功。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
运行成功。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
目标2：创建一个定时器，每 2 秒调用一次回调函数，主线程 1 秒后就停止定时器
根据路径，新建文件。
applications\sample\wifi-iot\app\timer_demo\timer_once.c。
applications\sample\wifi-iot\app\timer_demo\BUILD.gn。
编写源文件，定义定时器回调函数。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
创建主线程函数。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
定义运行入口函数。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
修改编译脚本。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
编译成功。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
烧录成功。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
运行成功。
【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示-开源基础软件社区
