Tickless 低功耗模式相关函数-优快云博客

本文链接：https://blog.youkuaiyun.com/wanghao312/article/details/146565556

FreeRTOS 的 Tickless 低功耗模式 是一种在系统空闲时暂停定时器中断（SysTick）的技术，允许微控制器（MCU）进入深度睡眠状态以降低功耗，直到下一个任务就绪或外部事件唤醒。此模式特别适用于电池供电的嵌入式设备。以下是 Tickless 模式的配置、核心 API 及实现原理的详细讲解。

Tickless 模式的核心原理

空闲时停用 SysTick
当系统进入空闲状态且无任务需要运行时，FreeRTOS 关闭 SysTick 中断，并根据下一个任务的唤醒时间计算 MCU 可睡眠的时长。
动态唤醒
使用低功耗定时器（如 RTC 或 LP Timer）在指定时间后唤醒 MCU，或依赖外部中断（如 GPIO、UART）提前唤醒。
时间补偿
睡眠期间跳过 SysTick 中断，通过硬件定时器记录实际睡眠时间，并在唤醒后修正系统时间。

Tickless 模式的配置

在 FreeRTOSConfig.h 中启用并配置以下宏：

宏定义	说明
`configUSE_TICKLESS_IDLE`	设为 `1` 启用 Tickless 模式。
`configEXPECTED_IDLE_TIME_BEFORE_SLEEP`	定义进入低功耗的最小空闲时间（单位：Tick）。若空闲时间小于此值，不进入睡眠。默认为 `2`。
`configPRE_SLEEP_PROCESSING`	用户自定义的预睡眠处理函数（关闭外设、降低时钟等）。
`configPOST_SLEEP_PROCESSING`	用户自定义的睡眠后恢复函数（恢复外设、时钟等）。

Tickless 模式的关键函数

1. 核心函数 `portSUPPRESS_TICKS_AND_SLEEP()`

功能：由 FreeRTOS 内核调用，用于进入低功耗状态并计算睡眠时间。
实现要求：需用户根据硬件平台实现此函数（通常位于 port.c 或独立驱动文件中）。
函数原型：
```
void portSUPPRESS_TICKS_AND_SLEEP(TickType_t xExpectedIdleTime);
```
- xExpectedIdleTime：预计的空闲时间（单位：Tick），即下一个任务的等待时间。

2. 预睡眠处理 `configPRE_SLEEP_PROCESSING`

功能：在进入低功耗前关闭高功耗外设或调整系统时钟。

示例：

void vPreSleepProcessing(uint32_t ulExpectedIdleTime) {
    // 关闭ADC、串口等外设
    HAL_ADC_Stop(&hadc);
    HAL_UART_DeInit(&huart1);
    // 切换为低速时钟
    SystemClock_Config_LowPower();
}

3. 睡眠后恢复 `configPOST_SLEEP_PROCESSING`

功能：唤醒后恢复外设和系统时钟。

示例：

void vPostSleepProcessing(uint32_t ulExpectedIdleTime) {
    // 恢复高速时钟
    SystemClock_Config_FullSpeed();
    // 重新初始化外设
    HAL_UART_Init(&huart1);
}

Tickless 模式的实现步骤

1. 硬件定时器配置

选择一个低功耗定时器（如 RTC 或 LPTIM）用于唤醒 MCU，并实现其初始化：

void LowPowerTimer_Init(void) {
    // 配置RTC或LPTIM，启用中断
    HAL_RTCEx_SetWakeUpTimer_IT(&hrtc, wakeup_ticks, RTC_WAKEUPCLOCK_RTCCLK_DIV16);
}

2. 实现 `portSUPPRESS_TICKS_AND_SLEEP()`

void portSUPPRESS_TICKS_AND_SLEEP(TickType_t xExpectedIdleTime) {
    uint32_t ulLowPowerTimeMs;

    // 计算实际睡眠时间（Tick转毫秒）
    ulLowPowerTimeMs = xExpectedIdleTime * portTICK_PERIOD_MS;

    // 配置低功耗定时器唤醒时间
    LowPowerTimer_SetWakeup(ulLowPowerTimeMs);

    // 进入低功耗模式（如STOP或STANDBY）
    HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI);

    // 唤醒后修正系统时间（通过硬件定时器实际睡眠时间）
    uint32_t ulActualSleepTimeMs = LowPowerTimer_GetElapsedTime();
    vTaskStepTick(ulActualSleepTimeMs / portTICK_PERIOD_MS);
}

3. 中断唤醒处理

在唤醒源的中断服务程序（如 RTC 唤醒中断）中清除标志，确保系统正确恢复：

void RTC_WKUP_IRQHandler(void) {
    HAL_RTCEx_DeactivateWakeUpTimer(&hrtc);
    __HAL_PWR_CLEAR_FLAG(PWR_FLAG_WU);
}

验证 Tickless 模式

电流测量
使用万用表或功耗分析仪测量 MCU 在空闲时的电流，确认进入低功耗状态后电流显著下降。

调试输出
在 configPRE_SLEEP_PROCESSING 和 configPOST_SLEEP_PROCESSING 中添加日志输出，验证睡眠和唤醒流程：

void vPreSleepProcessing(uint32_t ulExpectedIdleTime) {
    printf("Entering sleep for %lu ms\n", ulExpectedIdleTime * portTICK_PERIOD_MS);
}

任务调度监控
使用 FreeRTOS 的跟踪工具（如 traceTASK_SWITCHED_IN）确认任务唤醒后调度正常。

注意事项

中断配置
所有唤醒中断（如 GPIO、RTC）必须配置为在低功耗模式下有效，并确保中断标志在唤醒后清除。
外设状态管理
在睡眠前关闭或配置外设为低功耗模式，唤醒后需重新初始化（如 UART、SPI）。
时间精度
硬件定时器的精度影响系统时间修正，需校准时钟源（如 RTC 的时钟偏差）。
任务延迟
使用 vTaskDelay() 或 vTaskDelayUntil() 的任务需确保唤醒时间计算正确，避免因睡眠导致的任务延迟误差。

示例代码（基于 STM32 和 HAL 库）

FreeRTOSConfig.h 配置

#define configUSE_TICKLESS_IDLE              1
#define configEXPECTED_IDLE_TIME_BEFORE_SLEEP 5  // 空闲至少5 Ticks才进入睡眠
#define configPRE_SLEEP_PROCESSING( x )      vPreSleepProcessing(x)
#define configPOST_SLEEP_PROCESSING( x )     vPostSleepProcessing(x)

低功耗处理函数

void vPreSleepProcessing(uint32_t ulExpectedIdleTime) {
    // 关闭外设
    HAL_ADC_Stop(&hadc);
    HAL_UART_DeInit(&huart1);
    // 切换为MSI低速时钟
    SystemClock_Config_Sleep();
}

void vPostSleepProcessing(uint32_t ulExpectedIdleTime) {
    // 恢复时钟和外设
    SystemClock_Config_Wakeup();
    HAL_UART_Init(&huart1);
}