问题现象

某工业控制项目使用STM32F407 + FreeRTOS,创建一个周期任务每10ms读取一次传感器并更新PWM占空比。测试发现:运行几分钟后,PWM周期从10ms逐渐漂移到12ms以上,且漂移量随时间累积。用逻辑分析仪抓取任务切换引脚,确认任务执行间隔不固定。

排查过程

1. 检查任务优先级与中断

  • 任务优先级为5,高于其他应用任务,无同级任务抢占。
  • 系统节拍配置为configTICK_RATE_HZ = 1000,即1ms一个tick。
  • 关闭了时间片轮转,排除同级任务切换影响。

2. 分析任务代码

原代码如下:

void vSensorTask(void *pvParameters)
{
    TickType_t xLastWakeTime = xTaskGetTickCount();
    while (1)
    {
        // 读取传感器并更新PWM
        Sensor_Read();
        PWM_Update();

        // 错误:混用了vTaskDelay和vTaskDelayUntil
        if (some_condition)
        {
            vTaskDelay(pdMS_TO_TICKS(10));
        }
        else
        {
            vTaskDelayUntil(&xLastWakeTime, pdMS_TO_TICKS(10));
        }
    }
}

代码中根据条件分支分别调用vTaskDelay和vTaskDelayUntil。vTaskDelay是相对延时,从调用时刻开始计算;vTaskDelayUntil是绝对延时,基于上一次唤醒时间。混用导致xLastWakeTime未及时更新,且相对延时累积了任务执行时间与调度开销。

3. 量化误差

假设任务执行时间为1.2ms,调度开销0.3ms:

  • 使用vTaskDelay(10):实际周期 = 执行时间 + 10ms = 11.5ms,误差1.5ms/次。
  • 使用vTaskDelayUntil:实际周期 = 10ms(若执行时间<10ms),无累积误差。

混用时,每次进入vTaskDelay分支都会引入额外1.5ms误差,且xLastWakeTime未更新,下次进入vTaskDelayUntil分支时基准错误,误差进一步累积。

原理讲解

vTaskDelay

  • 相对延时:从调用时刻起阻塞指定tick数。
  • 实际周期 = 任务执行时间 + 延时时间 + 调度开销。
  • 适用于非周期性延时,如等待外设稳定。

vTaskDelayUntil

  • 绝对延时:基于pxPreviousWakeTime计算下一次唤醒的绝对tick。
  • 若任务执行时间小于周期,则周期严格等于设定值;若超时,则立即返回并更新基准。
  • 适用于固定周期任务,能消除累积误差。

正确配置步骤

  1. 确认configTICK_RATE_HZ与pdMS_TO_TICKS宏匹配。
  2. 周期任务统一使用vTaskDelayUntil,并在任务初始化时获取一次xLastWakeTime。
  3. 避免在周期任务中混用vTaskDelay,如需额外延时,应使用独立任务或状态机。
  4. 确保任务执行时间小于周期,否则需优化代码或调整周期。
  5. 使用调试引脚翻转验证实际周期。

完整代码示例

#include "FreeRTOS.h"
#include "task.h"

#define SENSOR_TASK_PERIOD_MS  10

static void Sensor_Read(void) { /* 读取传感器 */ }
static void PWM_Update(void) { /* 更新PWM */ }

void vSensorTask(void *pvParameters)
{
    TickType_t xLastWakeTime;
    const TickType_t xPeriod = pdMS_TO_TICKS(SENSOR_TASK_PERIOD_MS);

    // 初始化基准时间为当前tick
    xLastWakeTime = xTaskGetTickCount();

    for (;;)
    {
        // 周期任务主体
        Sensor_Read();
        PWM_Update();

        // 严格使用vTaskDelayUntil,绝不混用vTaskDelay
        vTaskDelayUntil(&xLastWakeTime, xPeriod);
    }
}

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_USART1_UART_Init();

    xTaskCreate(vSensorTask, "Sensor", 256, NULL, 5, NULL);
    vTaskStartScheduler();

    while (1) {}
}

注意事项

  • 不要混用:周期任务中只使用vTaskDelayUntil,非周期延时用vTaskDelay,两者不要出现在同一循环逻辑中。
  • 基准初始化:xLastWakeTime必须在任务第一次调用vTaskDelayUntil之前用xTaskGetTickCount()初始化。
  • 执行时间监控:若任务执行时间接近或超过周期,vTaskDelayUntil会立即返回,导致周期失效。可用GPIO翻转+示波器测量执行时间。
  • tick精度:configTICK_RATE_HZ越高,周期分辨率越好,但中断开销增大。一般1000Hz足够。
  • 调试技巧:在任务开始和结束时翻转一个GPIO,用逻辑分析仪观察实际周期与执行时间。

总结

本次问题根源是混用相对延时与绝对延时API,导致周期基准错乱和误差累积。修复后周期稳定在10ms±0.1ms。建议在团队编码规范中明确:周期任务一律使用vTaskDelayUntil,并在代码评审中检查。