FreeRTOS软件定时器使用学习笔记

已于 2023-10-23 20:52:33 修改
阅读量510 收藏 3
点赞数 3
分类专栏： # FreeRTOS 文章标签： 单片机 嵌入式硬件 stm32 mcu 学习 笔记
于 2023-10-23 20:49:46 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_47052167/article/details/133998604
版权

目录

一、简介

1、FreeRTOS定时器简介

2、相关宏

3、回调函数

二、相关函数详解

1、函数汇总

2、xTimerReset()

3、xTimerResetFromISR()

4、xTimerCreate（）

5、xTimerCreateStatic()

6、xTimerStart()

7、xTimerStartFromISR()

8、xTimerStop()

9、xTimerStopFromISR()

三、使用流程

1、创建定时器

2、编写回调函数

3、启动定时器

4、暂停定时器

一、简介

1、FreeRTOS定时器简介

freertos自带的定时功能，这是一个可选功能，使用将configUSE_TIMERS置为1，可配置为单次定时器和周期定时器，软件定时器允许设置一段时间，当设置的时间到达之后就执行指定的功能函数即回调函数，在回调函数中一定不能调用可以阻塞任务的API函数。

ps：相关函数在timers.c和timers.h中。

2、相关宏

宏说明
configUSE_TIMERS是否开启软件定时器功能
configTIMER_TASK_PRIORITY定时器任务优先级
configTIMER_QUEUE_LENGTH定时器队列长度
configTIMER_TASK_STACK_DEPTH定时器任务堆栈大小

3、回调函数

当定时器定时间到，会跳转到回调函数执行，回调函数没有函数名字的限制，参数必须为TimerHandle_t类型。例：

void AutoReloadTimeCallback(TimerHandle_t xTimer)

二、相关函数详解

1、函数汇总

函数描述
xTimerReset()复位软件定时器
xTimerResetFromISR()复位软件定时器，中断中
xTimerCreate()使用动态方法创建软件定时器。
xTimerCreateStatic()使用静态方法创建软件定时器。
xTimerStart()开启软件定时器，用于任务中。
xTimerStartFromISR()开启软件定时器，用于中断中。
xTimerStop()关闭软件定时器，用于任务中。
xTimerStopFromISR()关闭软件定时器，用于中断中。

2、xTimerReset()

  • 功能

    复位软件定时器，在使用定时器中途复位定时器，定时器会重新计时。

  • 函数

    BaseType_t xTimerReset( TimerHandle_t  xTimer, 
                            TickType_t xTicksToWait )

  • 参数

    xTimer：要复位的软件定时器的句柄。

    xTicksToWait：设置阻塞时间，调用函数 xTimerReset ()开启软件定时器其实就是向定时器命令队列发 送一条 tmrCOMMAND_RESET 命令，既然是向队列发送消息，那肯定会涉及到入队阻塞 时间的设置。

  • 返回值

    pdPASS: 软件定时器复位成功，其实就是命令发送成功。

    pdFAIL: 软件定时器复位失败，命令发送失败。

3、xTimerResetFromISR()

  • 功能

    复位软件定时器，在使用定时器中途复位定时器，定时器会重新计时。在中断中使用

  • 函数

    BaseType_t xTimerResetFromISR( TimerHandle_t xTimer,
                                BaseType_t * pxHigherPriorityTaskWoken );

  • 参数

    xTimer：要复位的软件定时器的句柄。

    pxHigherPriorityTaskWoken：记退出此函数以后是否进行任务切换，这个变量的值函数会自动设置的，用 户不用进行设置，用户只需要提供一个变量来保存这个值就行了。当此值为 pdTRUE 的时候在退出中断服函数之前一定要进行一次任务切换。

  • 返回值

        pdPASS: 软件定时器复位成功，其实就是命令发送成功。

        pdFAIL: 软件定时器复位失败，命令发送失败。

4、xTimerCreate（）

  • 功能

    创建一个软件定时器，所需要的内存由系统动态分配

  • 函数

    TimerHandle_t xTimerCreate( const char * const pcTimerName,
                                TickType_t xTimerPeriodInTicks,
                                UBaseType_t uxAutoReload,
                                void * pvTimerID,
                                TimerCallbackFunction_t pxCallbackFunction )

  • 参数

        pcTimerName:软件定时器的名字，字符串类型，用于调试

        xTimerPeriodInTicks：软件定时器的定时器周期， 单位是时钟节拍数，可以使用portTICK_PERIOD_MS 改变成ms单位，例如500ms即为：500/ portTICK_PERIOD_MS。

        uxAutoReload：是否重载，pdTURE：周期，pdFALSE：单次。

        pvTimerID：定时器的ID号。

        pxCallbackFunction： 定时器回调函数，当定时器定时周期到了以后就会调用这个函数。

  • 返回值

        NULL: 软件定时器创建失败。

        其他值: 创建成功的软件定时器句柄。

5、xTimerCreateStatic()

  • 功能

        创建一个软件定时器，所需要的内存由用户自己分配。

  • 函数

    TimerHandle_t xTimerCreateStatic(const char * const pcTimerName,
                                 TickType_t xTimerPeriodInTicks,
                                 UBaseType_t uxAutoReload,
                                 void * pvTimerID,
                                 TimerCallbackFunction_t pxCallbackFunction,
                                 StaticTimer_t * pxTimerBuffer )

  • 参数

        pcTimerName:软件定时器的名字，字符串类型，用于调试

        xTimerPeriodInTicks：软件定时器的定时器周期， 单位是时钟节拍数，可以使用portTICK_PERIOD_MS 改变成ms单位，例如500ms即为：500/ portTICK_PERIOD_MS。

        uxAutoReload：是否重载，pdTURE：周期，pdFALSE：单次。

        pvTimerID：定时器的ID号。

        pxCallbackFunction： 定时器回调函数，当定时器定时周期到了以后就会调用这个函数。

        pxTimerBuffer: 参数指向一个 StaticTimer_t 类型的变量，用来保存定时器结构体。

  • 返回值

        NULL: 软件定时器创建失败。

        其他值: 创建成功的软件定时器句柄。

6、xTimerStart()

  • 功能

    启动定时器，在任务中

  • 函数

    BaseType_t xTimerStart( TimerHandle_t  xTimer, 
                        TickType_t     xTicksToWait )

  • 参数

        xTimer： 要开启的软件定时器的句柄。

        xTicksToWait：设置阻塞时间，调用函数 xTimerStart()开启软件定时器其实就是向定时器命令队列发送一条 tmrCOMMAND_START 命令，既然是向队列发送消息，那肯定会涉及到入队阻塞时间的置。

  • 返回值

        pdPASS: 软件定时器开启成功，其实就是命令发送成功。

        pdFAIL: 软件定时器开启失败，命令发送失败。

7、xTimerStartFromISR()

  • 功能

    启动定时器，在中断中

  • 函数

    BaseType_t xTimerStartFromISR( TimerHandle_t  xTimer,
                                BaseType_t *  pxHigherPriorityTaskWoken );

  • 参数

    xTimer：要开启的软件定时器的句柄。

    pxHigherPriorityTaskWoken:退出是否进行任务切换......

  • 返回值

    pdPASS: 软件定时器开启成功，其实就是命令发送成功。

    pdFAIL: 软件定时器开启失败，命令发送失败。

8、xTimerStop()

  • 功能

    停止软件定时器，用于任务中。

  • 函数

    BaseType_t xTimerStop ( TimerHandle_t xTimer, 
                           TickType_t xTicksToWait );

  • 参数

    xTimer：要暂停的软件定时器的句柄。

    xTicksToWait:阻塞时间。

  • 返回值

    pdPASS: 软件定时器停止成功，其实就是命令发送成功。

    pdFAIL: 软件定时器停止失败，命令发送失败。

9、xTimerStopFromISR()

  • 功能

    停止软件定时器，用于中断中。

  • 函数

    BaseType_t xTimerStopFromISR( TimerHandle_t xTimer,
                               BaseType_t * pxHigherPriorityTaskWoken );

  • 参数

    xTimer：要暂停的软件定时器的句柄。

    pxHigherPriorityTaskWoken：退出是否进行任务切换......

  • 返回值

    pdPASS: 软件定时器停止成功，其实就是命令发送成功。

    pdFAIL: 软件定时器停止失败，命令发送失败。

三、使用流程

1、创建定时器

TimerHandle_t RrloadTimer_Handle;   //周期定时器句柄
TimerHandle_t OneShotTimer_Handle;  //单次定时器句柄
​
        ...
​
RrloadTimer_Handle = xTimerCreate("ReloadTime",
                                  1500/portTICK_PERIOD_MS,
                                  1, 
                                  (void *)1,
                                  AutoReloadTimeCallback);
OneShotTimer_Handle = xTimerCreate("OneShotTime",
                                   2000/portTICK_PERIOD_MS,
                                   0, 
                                   (void *)2,OneShotTimeCallback);    
      

2、编写回调函数

void AutoReloadTimeCallback(TimerHandle_t xTimer);
void OneShotTimeCallback(TimerHandle_t xTimer);
        ......
void AutoReloadTimeCallback(TimerHandle_t xTimer)
{
    Relodadnum++;
    LEDB_Toggle;
    printf("周期定时器执行%d次\r\n",Relodadnum);
}
void OneShotTimeCallback(TimerHandle_t xTimer)
{
    
    printf("单次定时器执行\r\n");
}
​

3、启动定时器

xTimerStart(RrloadTimer_Handle,20);
xTimerStart(OneShotTimer_Handle,20);

4、暂停定时器

void Task1(void * pvParaeters)
{
    BaseType_t err;
        while(1)
        {
            if(GPIO_ReadInputDataBit(GPIOA,GPIO_Pin_0) == 1)
            {
                printf("K1按下！\r\n");
                err = xTimerStop(RrloadTimer_Handle,20);
                if(err == pdPASS)
                {
                    printf("周期定时器暂停成功\r\n");
                }
                while(GPIO_ReadInputDataBit(GPIOA,GPIO_Pin_0) == 1);
            }
            if(GPIO_ReadInputDataBit(GPIOC,GPIO_Pin_13) == 1)
            {
                printf("K2按下！\r\n");
                err = xTimerStart(RrloadTimer_Handle,20);
                if(err == pdPASS)
                {
                    printf("周期定时器开启成功\r\n");
                }
                while(GPIO_ReadInputDataBit(GPIOC,GPIO_Pin_13) == 1);
            }
            vTaskDelay(200);
        }
}

小米和小米粥
关注
  • 3
    点赞
  • 踩
  • 3
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 1
    评论
专栏目录
【FreeRTOS】小白进阶之任务如何共用FreeRTOS软件定时器回调函数（二）
产品线负责人
09-10 3813
介绍两个定时器任务如何通过定时器 handle 共用一个回调函数。 1、头文件声明和函数定义 #include "FreeRTOS.h" #include "task.h" #include "timers.h" #include "supporting_functions.h" #define mainONE_SHOT_TIMER_PERIOD ( pdMS_TO_TICKS( 333...
FreeRTOS内核学习笔记
12-03
本学习笔记将聚焦于FreeRTOS的核心组件和机制，包括任务管理、内存管理、信号量、消息队列、软件定时器、任务通知以及事件标志组和低功耗管理。 首先，**任务管理**是FreeRTOS的核心功能之一。在FreeRTOS中，任务是...
【FreeRTOS基础入门】软件定时器
m0_62599305的博客
02-23 1252
在嵌入式系统开发中，时间管理是至关重要的一部分，特别是对于需要按时执行任务或操作的应用。FreeRTOS 提供了软件定时器的功能，使得开发者能够轻松地实现定时任务和事件调度。本篇文章将介绍 FreeRTOS 中的软件定时器，探讨其基础概念和简单应用，帮助读者快速上手并合理利用这一重要特性。软件定时器就像是你手机上的闹钟一样，它是一种程序内部的计时器。你可以设置它，在一段时间后触发一个事件或执行一个任务。比如，你可以设置一个软件定时器，在每天早上7点时触发一个提醒事件，让你起床。
FreeRTOS 软件定时器的使用
ba_wang_mao的专栏
10-21 5723
FreeRTOS 软件定时器的使用
FreeRTOS 体验教程：9.FreeRTOS的定时器初体验
LT450196683的专栏
06-22 1132
freeRTOS定时器来了，定时任务的自动执行，省时省心省力~
FreeRtos的软件定时器的使用
纸带的博客
11-26 1203
头文件#include "freertos/timers.h" 总体过程：申请→启动→定时 0.初始化/注册： Delay_Turnoff_timer_init(); Delay_Turnoff_timer_init();函数内容： /*------------------------------------------------------------------------------------------- 软件定时器创建函数 pcTimerName：软件定时器...
FreeRTOS——软件计时器
weixin_44567318的博客
07-26 1654
FreeRTOS——软件计时器软件计时器计时器服务（或守护进程）任务计时器守护进程配置一次性与自动重载 软件计时器 软件计时器概述 软件计时器（或只是“计时器”）允许在将来的设定时间执行函数。计时器执行的函数称为计时器的回调函数。计时器启动和执行其回调函数之间的时间称为计时器的周期。简单来说，计时器的计时时间到了，就会执行计时器的回调函数。 请注意，必须先明确创建软件计时器，然后才能使用它。 软件计时器实现中的效率考虑 软件定时器功能易于实现，但难以有效实现。FreeRTOS 实现不会在中断上下文执行计
FreeRTOS 教程指南 学习笔记 第五章 软件计时器
gjhave的博客
08-19 1142
软件计时器用于在未来设定的时间，或以固定的频率定期安排功能的执行。由软件计时器执行的函数称为软件计时器的回调函数。软件计时器由FreeRTOS内核实现，并在其控制之下。它们不需要硬件支持，也与硬件计时器或硬件计数器无关。请注意，根据FreeRTOS使用创新设计以确保最大效率的理念，软件计时器不占用任何处理时间，除非软件计时器回调函数实际执行。软件计时器功能是可选的。构建FreeRTOS源文件 FreeRTOS/Source/timers.c作为项目的一部分。
FreeRTOS（软件定时器）
qq_57594025的博客
08-14 2129
/定义ID号//定义软件定时器句柄。
FreeRTOS学习笔记
04-20
总的来说，这些学习资料全面覆盖了FreeRTOS的基础知识点，包括任务创建、同步机制（信号量、队列、邮箱和互斥量）以及软定时器的使用。通过深入学习和实践，初学者可以逐步掌握FreeRTOS的核心概念和技术，为开发高效...
ESP8266学习笔记（19）——定时器接口使用（RTOS SDK）
01-06
以下为ESP_IDF软件定时器API 用于替代旧SDK中ets_timer软件定时器API。 尽管FreeRTOS提供了软件计时器，但是这些计时器有一些限制： 最大分辨率等于RTOS滴答周期 计时器回调从低优先级任务分派 硬件计时器不受这两个...
freeRTOS操作系统学习笔记
12-24
5. **软件定时器（Software Timers）**：模拟硬件定时器，提供周期性或一次性回调功能，可用于延时、超时检测等。 6. **队列（Queues）**：用于任务间的数据传输，支持不同类型的数据结构，如字符、字节、结构体等...
FreeRTOS学习篇八：软件定时器
weixin_45647341的博客
09-12 1016
FreeRTOS的软件定时器的基本概念、常用函数，以及使用示例。
详解FreeRTOS中的软件定时器
闪耀大叔的博客
04-06 3035
软件定时器用于让某个任务定时执行，或者周期性执行。
基于FreeRTOS的正倒计时器程序设计
yilongdashi的博客
12-24 886
18、基于FreeRTOS的正倒计时器程序设计 使用绝对延时函数产生0.01秒基时，进而产生秒、分，在LCD上显示分钟、秒、秒小数各2位；用4个按钮控制正计时、倒计时、启动、停止。在LCD上显示出当前的计时方式。 系统任务：键盘扫描任务，键值处理任务，正计时任务，倒计时任务；优先级按此顺序。 键盘扫描任务借助邮箱，把4个按钮的按键值1～4发送出去，键值处理任务接收邮箱消息。 键值处理任务：等待...
FreeRTOS 实时操作系统第十五讲 - 软件定时器
qq_37391577的博客
01-09 162
FreeRTOS 软件定时器的时基是基于系统时钟节拍实现的，之所以叫软件定时器是因为它的实现不需要额外使用硬件定时器，而且可以创建很多个，综合这些因素，这个功能就被称之为软件定时器组。既然是定时器，那么它实现的功能与硬件定时器也是类似的。在硬件定时器中，我们是在定时器中断中实现需要的功能，而使用软件定时器时，我们是在创建软件定时器时指定软件定时器的回调函数，在回调函数中实现相应的功能。
FreeRTOS 计时 sysTimeTick 系统时钟节拍
最新发布
【全部原创，全部干货】【Android、车载MCU、AIGC】
07-10 228
开发人员可以根据需要设置不同的tick率，但是较高的tick率可以提供更精细的时间控制，但同时也会增加CPU的开销，因为需要更频繁地处理定时器中断。是通过一个定时器中断来实现的，这个中断会定期触发，每次触发都会增加系统的时间计数器。当程序逻辑判断，遇到异常情况 - sysTimeTick变得非常小，意味着重新从0计数了，这时或许要补上这个最大值后，再去做判断。的最小计时单位是tick，也就是系统时钟的节拍间隔。是FreeRTOS中用于时间管理的核心机制，它的精度和性能取决于系统配置和定时器中断的频率。
7-FreeRTOS软件定时器
南山府的博客
12-04 652
软件定时器就是允许函数设置一定的等待时间，然后执行。定时器执行的函数被称为定时器的回调函数。定时器从启动到执行回调函数之间的时间称为定时器的周期。定时器的回调函数在定时器的时间到达时执行。 软件定时器要先创建才能使用。软件定时器功能的实现是非常容易的，但是想要有效的实现可能会优点困难，FreeRTOS的定时器，不会从中断中执行定时器的回调函数，除非定时器到达了，否则不会消耗任何的运算时间，不会像时钟中添加任何的运算负担，如果中断禁用了，也不会遍历任何的链表结构。 定时器服务任务主要利用了FreeRTOS的一
【FreeRtos教程九】STM32 CubeMx——Timers(定时器)
Joseph Wen的博客
03-24 1914
定时器是MCU常用的外设，我们在学习各种单片机时必然会学习它的硬件定时器。但是，MCU自带的硬件定时器资源是有限的，而且一般会用在实时性要求很强的地方。 在freeRTOS中提供了软件定时器的功能，来实现更多的定时器资源。
freertos知识体系学习笔记
09-12
在学习FreeRTOS的知识体系时，你可以按照以下步骤进行笔记的整理： 1. 了解FreeRTOS的基本情况：包括它的特色、目录结构与文件说明等。 2. 学习原生程序的下载与目录结构：了解如何下载原生程序，并了解其目录结构。...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

小米和小米粥

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值