osTimerStart() / xTimerStart() / xTimerChangePeriod()

Sparking-Water

已于 2024-07-16 14:27:25 修改

阅读量1.5k

点赞数 16

文章标签：单片机嵌入式硬件

于 2024-07-16 14:16:46 首次发布

本文链接：https://blog.csdn.net/z398613041/article/details/140464909

版权

在嵌入式实时操作系统（RTOS）中的 `osTimerStart()` 函数参数通常包含以下信息：

定时器句柄（Timer Handle）：它是一个指向已经创建的定时器的指针或标识符。通过定时器句柄，函数可以找到对应的定时器并进行启动操作。
延迟时间（Delay Time）：它表示定时器启动后第一次触发的延迟时间。延迟时间指定了定时器从启动到第一次触发的时间间隔。这个参数是一个以毫秒为单位的时间值。

例如，使用 FreeRTOS 的定时器功能时，osTimerStart() 函数的参数可以是以下形式：

osStatus_t osTimerStart(osTimerId_t timer, uint32_t millisec);

需要根据具体的 RTOS 版本和实现来确定函数参数的具体含义。可以查阅相应的 RTOS 文档或参考相关函数的定义文档，以获得准确的参数解释和用法说明

BaseType_t xTimerChangePeriod(TimerHandle_t xTimer, TickType_t xNewPeriod, 
                                TickType_t xTicksToWait);

返回值是一个 BaseType_t 类型的值，表示函数执行的结果。如果定时器句柄无效或发生错误，返回 pdFAIL；否则，返回 pdPASS 表示成功修改了定时器周期。

需要注意的是，在调用 xTimerChangePeriod() 函数之前，要确保定时器已经创建并且正在运行。否则，可能会导致意外的行为或错误的结果。

使用 xTimerChangePeriod() 函数可以动态地修改定时器的周期，使其在运行时适应不同的时间间隔需求。这对于需要动态调整定时器触发频率的应用场景非常有用。

BaseType_t xTimerStart(TimerHandle_t xTimer, TickType_t xTicksToWait);

返回值是一个 BaseType_t 类型的值，表示函数执行的结果。如果定时器句柄无效或发生错误，返回 pdFAIL；否则，返回 pdPASS 表示成功启动了定时器。

需要注意的是，在调用 xTimerStart() 函数之前，要确保定时器已经创建并且已配置好相关参数。否则，可能会导致意外的行为或错误的结果。

使用 xTimerStart() 函数可以使定时器开始计时，并按照预设的时间间隔触发定时器的回调函数。一旦定时器启动，它会按照设定的时间间隔循环触发，直到被停止或删除。

此外，如果需要在定时器启动后立即触发一次定时器回调函数，可以先调用 xTimerReset() 函数重置定时器，然后再调用 xTimerStart() 启动定时器。

总结起来，xTimerStart() 的作用是启动一个已经创建的定时器，使其开始计时并按照预设的时间间隔触发定时器的回调函数。

使用方法：
- xTimerChangePeriod()：用于修改定时器的周期。该函数将定时器的触发时间间隔更改为指定的值，并可选择性地使定时器自动重新启动。
- xTimerStart()：用于启动定时器。该函数开始定时器的计时，并在指定的初始延迟时间后触发定时器。
区别：
- xTimerChangePeriod() 修改定时器的周期，即定时器触发的时间间隔，而不会影响定时器的状态（启动/停止）或引起定时器重启。
- xTimerStart() 启动定时器，并且可以设置一个初始延迟时间。它会启动定时器的计时，并在初始延迟时间后触发定时器。如果定时器之前已经启动过，则定时器将按照上次停止时的状态继续计时。

在使用时，您可以根据需要选择使用这两个函数：

需要注意的是，在使用这两个函数之前，您需要先创建一个定时器，并获取其句柄。定时器的创建可以使用 xTimerCreate() 函数来完成。

间。

xTimerChangePeriod() 函数的第二个参数是新的定时器周期。它指定了定时器的新的触发时间间隔。这个参数是一个以时钟节拍为单位的时间值（Ticks）。时钟节拍的长度由 FreeRTOS 的配置文件确定，可以使用 pdMS_TO_TICKS() 宏将毫秒转换为时钟节拍。
xTimerStart() 函数的第二个参数是定时器的初始延迟时间。它指定了定时器启动后第一次触发的时间。这个参数也是一个以时钟节拍为单位的时间值（Ticks）。

尽管这两个参数都表示时间，但它们的作用不同：