前言

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

软定时器

软定时器含义

软件定时器(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
编写源文件，定义定时器回调函数

创建主线程函数



定义运行入口函数

修改编译脚本

编译成功

烧录成功

运行成功