SeanLib系列函数库-MyTimer

查看其它库函数说明请点击此处跳转到SeanLib主页1. 本篇内容本篇讲MyTimer是一个轻量级的软件定时器/计数器库基于链表实现支持动态创建和销毁定时器。适用于嵌入式系统如 STM32、AVR、ESP32 等平台可在中断服务程序中调用以实现毫秒级精确定时。本库依赖链表库 MyList。主要特性支持动态创建/销毁定时器支持单次触发或循环触发支持有限次数触发如触发 3 次后自动停止每个定时器可绑定独立的回调函数提供暂停、恢复、停止等运行控制可作为计数器使用不依赖系统滴答定时器链表管理遍历效率高2. 使用说明先看头文件里面定义了一个定时器设备类型和一个创建定时器的函数以及一个使定时器时间/计数器增加的函数。头文件内容如下#includeMyList.h#includeSeanLib.htypedefstruct//定义一个软件定时器也可以当做计数器使用{unsignedcharRun;//读写定时器控制0表示停止1表示运行unsignedcharTimeOutFlag;//读写计时时间到标志1表示时间到unsignedcharBack1;unsignedcharBack2;unsignedintTime;//私有定时目标时间单位msunsignedintTick;//私有实时计数值单位msunsignedintTrigTimes;//读写触发次数0表示始终运行void(*TimeOutFunc)(void);//函数指针计时时间到时触发该函数void(*Dispose)(void);//函数指针释放定时器void(*Start)(void);//函数指针启动或恢复暂停的定时器void(*Pause)(void);//函数指针暂停定时器void(*Stop)(void);//函数指针停止定时器}MyTimer_t;/******************************************************************************* * 功 能: 创建一个软定时器创建之后自动启动 * 参 数: * Time : 定时时间单位为ms * TimeOut : 函数指针指定一个定时时间到后触发的函数不指定就设置为NULL * TrigTimes: 设置该定时器的触发次数0表示连续触发 * 返回值: 创建成功返回定时器指针否则返回空指针NULL *******************************************************************************/MyTimer_t*NewMyTimer(unsignedintTime,void(*TimeOut)(void),unsignedintTrigTimes);/******************************************************************************* * 功 能: 定时器计时函数每调用一次该函数所有已开启的定时器时间都会增加 当做定时器使用时请将该函数放到系统滴答定时中断程序中计时周期为1ms 当做计数器使用时请在需要的地方调用该函数 * 参 数: 无 * 返回值: 无 *******************************************************************************/voidMyTimer_Tick(void);3. 作为定时器的用法典型用法为定时器本篇不讲作为计数器的用法因为要用计数器的话完全可以用一个变量来计数。3.1 创建定时器如下代码演示了创建一个定时周期为1s的定时器用于控制状态灯的闪烁代码如下voidTimer_Init(void){externvoidLED_Flash(void);Tmr_StateNewMyTimer(1000,LED_Flash,0);if(Tmr_StateNULL){Error_Handle(0,Creat LED Flash Timer failed!);}}MSH_INIT_EXPORT(2,Timer_Init,Creat Timer);3.2 编写回调函数回调函数非必须当不需要回调函数的时候创建的时候写NULL即可。在项目的其它位置编写 LED_Flash 函数voidLED_Flash(void){LED_STATE!LED_STATE;}该定时器每1000调用一次 LED_Flash 函数永不停止。3.3 定时调用MyTimer_Tick要想使定时器的计时值增加需要每ms调用一次MyTimer_Tick使用HAL库的情况下将 MyTimer_Tick 放入系统滴答定时中断程序中在项目工程中找到xxx_it.c文件找到 SysTick_Handler 函数添加调用 MyTimer_Tick 函数如下voidSysTick_Handler(void){// USER CODE BEGIN SysTick_IRQn 0MyTimer_Tick();//放在此处// USER CODE END SysTick_IRQn 0HAL_IncTick();// USER CODE BEGIN SysTick_IRQn 1// USER CODE END SysTick_IRQn 1}如果不使用HAL库你需要创建一个1ms的定时器在其中断中调用 MyTimer_Tick 函数。这样程序运行后状态灯就会开始闪烁了。3.4 其它用法当不使用回调函数采用判断 TimeOutFlag 属性的方法时使用下面语句创建定时器voidTimer_Init(void){Timer_500msNewMyTimer(500,NULL,0);if(Timer_500msNULL){Error_Handle(0,Creat 500ms Timer failed!);}}MSH_INIT_EXPORT(2,Timer_Init,Creat 500ms Timer);应用代码中通过检查 TimeOutFlag 来判断时间有没有到该标志需要软件清零if(Timer_500ms-TimeOutFlag){Timer_500ms-TimeOutFlag0;LED_STATE!LED_STATE;//....}有些时候希望某个操作执行有限次数比如控制LED亮灭交替3次可以用有限次数触发的定时器来实现在创建定时器时设置触发次数为6因为亮灭一次需要触发两次代码如下voidLED_Flash(void){LED_STATE!LED_STATE;}voidTimer_Init(void){Tmr_StateNewMyTimer(1000,LED_Flash,6);if(Tmr_StateNULL){Error_Handle(0,Creat LED Flash Timer failed!);}}MSH_INIT_EXPORT(2,Timer_Init,Creat Timer);如此亮灭3次之后定时器停止若要再次启动可调用 Start 方法但需要注意再次启动后触发次数需要重新设置若不设置则会连续触发每秒触发一次。4. 特别说明当使用有限次数触发的定时器时在停止后不含暂停要再次启动前需要再次设置触发次数否则会连续触发。