xTaskGetTickCount() 是 FreeRTOS 实时操作系统中的一个 API 函数，用于获取系统启动后经过的 时钟滴答（tick）总数。以下是详细解释：

函数功能

• 返回当前 Tick 计数：
  系统启动时，一个硬件定时器会以固定频率（由 configTICK_RATE_HZ 配置，如 1000 Hz = 1ms/tick）触发中断，每次中断称为一个 “tick”。
  此函数返回从系统启动到当前时刻累积的 tick 数量。

• 数据类型：
  返回 TickType_t 类型（通常为 uint32_t），表示无符号 32 位整数。
  注意：计数值会溢出！ 当计数达到 0xFFFFFFFF 后会归零（取决于 TickType_t 的位宽）。

典型用途

1. 时间间隔测量：
   记录起始和结束的 tick 值，计算差值得出时间（需考虑溢出）：

   TickType_t start = xTaskGetTickCount();
   do_something();
   TickType_t duration = xTaskGetTickCount() - start; // 耗时（tick数）

2. 超时控制：
   在阻塞操作中指定等待的最大 tick 数：

   if (xSemaphoreTake(semaphore, pdMS_TO_TICKS(100)) != pdTRUE) {
    // 等待信号量超时（100ms）
   }

3. 周期性任务调度：
   通过 vTaskDelayUntil() 实现精确周期执行。

注意事项

1. 溢出处理：
   直接比较时间差时，需使用 pdTICKS_TO_MS() 或手动处理溢出：

   // 安全的时间差计算（即使溢出）
   TickType_t diff = (end >= start) ? (end - start) : (0xFFFFFFFF - start + end);

2. 中断安全版本：
   在中断服务程序（ISR）中调用其后缀为 FromISR 的版本：

   TickType_t xTaskGetTickCountFromISR(); // 中断安全

3. 与时间单位的转换：
   FreeRTOS 提供宏进行 tick 与毫秒的转换：

   #define pdMS_TO_TICKS(ms)  ((TickType_t)((ms) / portTICK_PERIOD_MS)) // ms → tick
   #define pdTICKS_TO_MS(ticks)  ((ticks) * portTICK_PERIOD_MS)          // tick → ms

函数原型

#include "task.h"
TickType_t xTaskGetTickCount(void); // 任务中调用
TickType_t xTaskGetTickCountFromISR(void); // 中断中调用

示例代码

void vTaskPeriodic(void *pvParameters) {
    TickType_t xLastWakeTime = xTaskGetTickCount(); // 记录起始时间
    const TickType_t xPeriod = pdMS_TO_TICKS(100);  // 周期 = 100ms

    for (;;) {
        vTaskDelayUntil(&xLastWakeTime, xPeriod);  // 精确周期延迟
        perform_task();                            // 周期执行的任务
    }
}

总结

xTaskGetTickCount() 是 FreeRTOS 中用于 获取系统运行时间基准的核心函数，适用于时间测量、超时控制和周期性调度。使用时需注意 tick 溢出 和 中断安全 问题，合理利用 API 可构建可靠的实时程序。