PAYATHON 2026

同优先级 FreeRTOS 任务为何反复抢到非阻塞 UART 写?

数据小陈

结论

Task 2 能反复拿到 CPU 并重新获取 xPrintMutex,原因在于时间片只在 SysTick 边界轮转同优先级就绪任务,configUSE_TIME_SLICING 本身是生效的。xSemaphoreGive() 释放互斥量后,Task 1 即使被唤醒,也不会立刻抢占同优先级的 Task 2。两次 tick 之间,Task 2 可以连续完成多次 take、write、give,并在 Task 1 真正运行前再次拿到锁。

另外,SERCOM4_USART_Write() 是非阻塞接口。返回 true 只表示本次请求被接受,返回 false 表示当前 UART 还不能接收新数据,两者都不表示发送已经完成。原代码在调用后马上释放互斥量,下一个任务很容易看到 UART 仍处于 busy 状态,导致写入失败。

原因分析

  1. 时间片不会在每个循环都切换
    configUSE_TIME_SLICING 只让同优先级就绪任务在 tick 中断时轮转。任务循环内部不会因为 xSemaphoreGive() 自动切换到同优先级任务。Task 2 释放锁后继续往下执行,马上又调用 xSemaphoreTake(),锁仍可用,于是它再次成功获取。

  2. 同优先级任务不会触发立即抢占
    FreeRTOS 在 xSemaphoreGive() 唤醒等待者时,如果被唤醒任务的优先级更高,通常会立即抢占;如果优先级相同,当前任务仍可继续运行。所以 Task 1 从 blocked 变为 ready 后,不一定马上得到 CPU。

  3. 互斥量保护的是 API 调用,不是 UART 传输完成
    原代码保护的是 SERCOM4_USART_Write() 这一次调用。函数返回后锁就释放了,但 UART 可能还在发送。Task 1 拿到锁时 UART 仍 busy,写入返回 false。

  4. 紧循环放大了不公平
    两个任务都没有调用 vTaskDelay() 或 taskYIELD(),Task 2 在一个 tick 内可以反复拿锁。即使 tick 到来,如果 Task 1 正因锁被占用而阻塞,Task 2 仍可能是唯一就绪任务。FreeRTOS 互斥量不保证严格 FIFO,同优先级下不能依赖“先等先得”。

  5. 阻塞模式看起来正常的原因
    阻塞写会等传输完成或等到可以写,所以调用返回时 UART 状态已经推进,不容易出现立即 busy 失败。但阻塞写会占用任务时间,仍需结合系统实时性评估。

解决步骤

  1. 避免多个任务用紧循环争抢同一个非阻塞 UART。
  2. 为 UART TX 完成建立同步机制,例如在 TX complete 中断或回调中释放信号量。
  3. 推荐改成单一 UART writer task:其他任务把消息放入队列,由 writer task 串行提交并等待完成。
  4. 如果保留两个任务,拿锁后调用 SERCOM4_USART_Write();若返回 false,释放锁并等待 TX 完成事件或短延时后重试,避免持锁忙等。
  5. 提交成功后,最好等本次 TX 完成再释放 xPrintMutex,这样下一个任务不会在 UART busy 时写入。
  6. 检查 xSemaphoreTake() 的返回值,处理超时和错误,避免系统卡死。

代码示例

下面示例假设 Harmony 驱动能提供 TX complete 回调或中断入口,回调函数名以实际工程配置为准。核心思路是用 xUartTxDone 表示一次发送完成,不再靠紧循环反复试写。

static SemaphoreHandle_t xUartTxDone;

/* 占位示例:在 UART TX complete 中断/回调中调用 */
void UART_TxCompleteHook(void)
{
    BaseType_t hpw = pdFALSE;
    xSemaphoreGiveFromISR(xUartTxDone, &hpw);
    portYIELD_FROM_ISR(hpw);
}

static void uart_print(const char *msg)
{
    xSemaphoreTake(xPrintMutex, portMAX_DELAY);

    while (!SERCOM4_USART_Write((uint8_t *)msg, strlen(msg)))
    {
        /* 没提交成功:先释放锁,等 TX 完成后再试 */
        xSemaphoreGive(xPrintMutex);
        xSemaphoreTake(xUartTxDone, pdMS_TO_TICKS(10));
        xSemaphoreTake(xPrintMutex, portMAX_DELAY);
    }

    /* 提交成功后等待本次发送完成,避免下一个任务看到 busy */
    xSemaphoreTake(xUartTxDone, pdMS_TO_TICKS(100));

    xSemaphoreGive(xPrintMutex);
}

更稳妥的结构是消息队列加单 writer task:

void UART_WriterTask(void *pvParameters)
{
    const char *msg;

    for (;;)
    {
        if (xQueueReceive(xPrintQueue, &msg, portMAX_DELAY) == pdPASS)
        {
            while (!SERCOM4_USART_Write((uint8_t *)msg, strlen(msg)))
            {
                xSemaphoreTake(xUartTxDone, pdMS_TO_TICKS(10));
            }

            xSemaphoreTake(xUartTxDone, pdMS_TO_TICKS(100));
        }
    }
}

注意事项

  • 调用 xSemaphoreGiveFromISR() 时必须使用中断安全版本,并正确调用 portYIELD_FROM_ISR()。
  • 二进制信号量可能积累上一次发送完成事件。初始化后要结合驱动状态清理一次,避免误判。
  • 不要在持锁时无限等待 TX 完成;设置合理超时,并处理 UART 错误。
  • 如果消息较长或频率较高,队列加单 writer task 比双任务争锁更清晰,也更容易控制顺序。
  • configUSE_TIME_SLICING 只保证同优先级就绪任务按 tick 轮转,不保证互斥量公平,也不保证释放锁后立即切换。

备注:内容仅供参考。