【OpenHarmony内核编程接口】介绍定时器管理两种定时器以及案例演示

前言

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

软定时器

软定时器含义

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

一次性定时器

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

周期性定时器

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

API接口介绍

==1.==osTimerNew

• 功能：创建并初始化一个定时器
• 定义：osTimerId_t osTimerNew (osTimerFunc_t func, osTimerType_t type, void *argument, const osTimerAttr_t *attr)
• 参数：func ：定时器回调函数 type ：定时器类型。osTimerOnce 一次性定时器， osTimerPeriodic 周期性定时器。 argument ：定时器回调函数的参数 attr ：定时器属性
• 返回值：成功返回定时器id，失败返回 NULL ==2.==osTimerGetName
• 功能：获取指定ID的定时器的名称
• 定义：const char *osTimerGetName(osTimerId_t timer_id)
• 参数：timer_id ：定时器 ID ，由 osTimerNew 生成
• 返回值：成功返回定时器的名称，失败返回 NULL ==3.==osTimerStart
• 功能：启动或者重启指定ID的定时器
• 定义：osStatus_t osTimerStart(osTimerId_t timer_id, uint32_t ticks)
• 参数：imer_id ：定时器ID，由 osTimerNew 生成 ticks ：定时器的间隔
• 返回值：osOK ：操作成功 osErrorISR ：不能从中断服务程序中调用 osErrorParameter ：参数错误 osErrorResource ：定时器状态无效 ==4.==osTimerStop
• 功能：停止指定ID的定时器
• 定义：osStatus_t osTimerStop (osTimerId_t timer_id)
• 参数：timer_id ：定时器ID ，由 osTimerNew 生成
• 返回值：osOK ：操作成功 osErrorISR ：不能从中断服务程序中调用 osErrorParameter ：参数错误 osErrorResource ：定时器不在运行状态(只能停止运行态的定时器) ==5.==osTimerIsRunning
• 功能：检查指定ID的定时器是否在运行
• 定义：uint32_t osTimerIsRunning (osTimerId_t timer_id)
• 参数：timer_id ：定时器ID，由 osTimerNew 生成
• 返回值：1 ：运行 0 ：没有运行或发生错误 ==6.==osTimerDelete
• 功能：删除指定ID的定时器
• 定义：osStatus_t osTimerDelete (osTimerId_t timer_id)
• 参数：timer_id ：定时器ID，由 osTimerNew 生成
• 返回值：osOK ：操作成功 osErrorISR ：不能从中断服务程序中调用 osErrorParameter ：参数错误 osErrorResource ：定时器状态无效

案例演示

目标1：创建一个定时器，每 1 秒调用一次回调函数，回调函数给全局变量 times+1，主线程等待 3 秒，停止并删除定时器。 准备开发套件 根据路径，新建文件 applications\sample\wifi-iot\app\timer_demo\timer.c applications\sample\wifi-iot\app\timer_demo\BUILD.gn 编写源文件 必要的头文件 定义全局变量和定时器回调函数 创建主线程函数 定义入口函数，运行入口函数 编写编译脚本，注意路径 编译成功 烧录成功 运行成功 目标2：创建一个定时器，每 2 秒调用一次回调函数，主线程 1 秒后就停止定时器 根据路径，新建文件 applications\sample\wifi-iot\app\timer_demo\timer_once.c applications\sample\wifi-iot\app\timer_demo\BUILD.gn 编写源文件，定义定时器回调函数 创建主线程函数 定义运行入口函数 修改编译脚本 编译成功 烧录成功 运行成功

本文作者：他们都叫我KAI

想了解更多关于开源的内容，请访问：​​

​​51CTO 开源基础软件社区​​

​​https://ost.51cto.com/#bkwz​​