rtthtead软件定时器

RT-Thread是一个实时操作系统，它内置了多种定时器（软件定时器和硬件定时器）来实现任务调度和时间管理。

软件定时器是指RT-Thread中用于实现延时和定时操作的一种机制。它使用内部计数器进行计时，并在计时达到设定值时触发相应的回调函数。软件定时器可以用来实现延时等待、周期性执行任务等功能。

RT-Thread中的软件定时器使用了最小堆来管理定时器列表，保证了定时器的按时序触发。除了软件定时器，RT-Thread还支持硬件定时器，可以利用芯片内部的定时器来实现更精确的定时任务。

相关问题

软件定时器 freertos

### 设置和使用 FreeRTOS 软件定时器

#### 配置 FreeRTOS 使用软件定时器
为了使 FreeRTOS 支持软件定时器功能，`configUSE_TIMERS` 配置项需设为 `1`。这会在启动调度器时自动创建一个 RTOS 守护任务用于处理所有的软件定时器操作[^1]。

#### 创建软件定时器
创建一个新的软件定时器可以通过调用 `xTimerCreate()` 函数实现。此函数允许指定定时器名称、周期时间、是否重复执行以及回调函数等参数。需要注意的是，刚创建的软件定时器默认处于休眠状态，并不会立即开始计时[^2]。

// 创建一个名为 "OneShotTimer" 的一次性定时器
const TickType_t xTimerPeriod = pdMS_TO_TICKS(5000); // 5秒
StaticTimer_t xTimerBuffer;
TimerHandle_t xTimer;

xTimer = xTimerCreateStatic(
    "OneShotTimer",          /* 名字 */
    xTimerPeriod,            /* 周期 (单位: ticks) */
    pdFALSE,                 /* 是否循环 */
    (void *)0,               /* ID */
    vTimerCallbackFunction,  /* 回调函数 */
    &xTimerBuffer           /* 缓冲区地址 */
);

#### 启动软件定时器
要激活已创建但尚未运行的软件定时器，可利用 `xTimerStart()` 或者 `xTimerChangePeriod()` 来改变其间隔并同时将其置于活动状态。一旦启动成功，守护线程就会负责监控该定时器直到超时事件发生。

if (xTimer != NULL)
{
    // 开启定时器
    if (xTimerStart(xTimer, 0) != pdPASS)
    {
        // 处理错误...
    }
}

#### 利用定时器ID传递数据至回调函数
在定义定时器时所传入的那个 `(void*)` 类型指针即作为定时器ID存在；它可以携带额外的信息到回调函数内部供后续逻辑判断之用。例如，可以用作区分不同类型的定时器或是存储某些特定数值以便于回调期间访问[^3]。

static void vTimerCallbackFunction(TimerHandle_t pxTimer)
{
    uint32_t ulParameter = (uint32_t)pvTimerGetTimerID(pxTimer);

    // 根据ulParameter做不同的事情...

    configASSERT(ulParameter == 0UL || ulParameter == 1UL);
}

freeRTOS软件定时器

### FreeRTOS 软件定时器使用方法

#### 创建软件定时器
创建一个软件定时器可以通过调用 `xTimerCreate` 函数完成。此函数允许指定定时器名称、周期时间、是否自动重载以及回调函数。

TimerHandle_t xTimer;
const TickType_t xTimerPeriodInTicks = pdMS_TO_TICKS(100); // 100ms 周期

// 创建一个周期性的软件定时器
xTimer = xTimerCreate(
    "Timer",                    /* 定时器名字 */
    xTimerPeriodInTicks,        /* 周期时间 (ticks) */
    pdTRUE,                     /* 自动重装载 */
    (void *)0,                  /* 定时器ID */
    vTimerCallback              /* 回调函数 */
);

#### 启动和停止定时器
一旦创建了定时器，就可以通过 `xTimerStart` 和 `xTimerStop` 来控制其启动与停止状态。

if (xTimer != NULL) {
    // 启动定时器
    if (xTimerStart(xTimer, 0) != pdPASS) {
        // 处理启动失败的情况
    }

    // ... 运行一段时间 ...

    // 停止定时器
    if (xTimerStop(xTimer, 0) != pdPASS) {
        // 处理停止失败的情况
    }
}

#### 删除定时器
当不再需要某个定时器时，应该调用 `vTimerDelete` 将其删除以释放资源。

if (xTimer != NULL) {
    vTimerDelete(xTimer);
}

#### 设置定时器行为
FreeRTOS 的软件定时器支持多种配置选项，比如设置为一次性触发还是重复触发等特性[^4]。

// 修改已存在的定时器属性
configTIMER_ENABLE_AUTO_RELOAD; // 开启/关闭自动重载模式

#### 错误处理机制
为了确保系统的稳定性，在每次调用 API 函数之后都应该检查返回值并采取相应的措施来应对潜在的问题。

BaseType_t xReturn;

xReturn = xTimerChangePeriod(xTimer, newPeriod, portMAX_DELAY);

if (xReturn == pdFAIL) {
    // 执行错误恢复逻辑...
}