STM32 HAL库定时器实现delay常见问题解析

Question

在使用STM32 HAL库通过定时器实现精确延时（delay）时，一个常见问题是：**调用`HAL_Delay()`后程序卡死或中断无法响应**。该问题通常源于开发者未正确启用SysTick中断，或在主循环中频繁调用`HAL_Delay()`导致阻塞任务调度。此外，若用户尝试通过自定义定时器替代SysTick实现`HAL_Delay()`，但未同步更新`HAL_GetTick()`函数的计时机制，将导致延时失准或无限等待。需注意，`HAL_Delay()`依赖于`HAL_IncTick()`的周期性调用，若在中断中执行延时操作而关闭了全局中断，亦会破坏其工作机制。如何在不阻塞系统的情况下实现高精度延时？

Answer 1

1. 问题背景与常见现象分析

在使用STM32 HAL库进行嵌入式开发时，HAL_Delay() 是最常用的延时函数之一。然而，许多开发者在实际项目中发现：调用该函数后程序出现“卡死”、外设中断无法响应、RTOS任务调度停滞等问题。这种现象的本质是 HAL_Delay() 的阻塞性质和其对系统滴答定时器（SysTick）的强依赖性。

具体表现包括：

• 主循环中频繁调用 HAL_Delay(1) 导致CPU占用率接近100%
• 自定义定时器替代 SysTick 后，HAL_GetTick() 返回值不再更新
• 在中断服务例程（ISR）中调用 HAL_Delay() 引发死循环
• SysTick 中断被意外关闭或优先级设置不当导致计时中断未触发

这些问题的根本原因在于未能理解 HAL 库的时间基准机制及其运行时依赖关系。

2. HAL_Delay() 工作机制深度解析

HAL_Delay() 并非硬件延时，而是基于软件轮询实现的阻塞式延时函数。其核心逻辑如下：

void HAL_Delay(uint32_t Delay)
{
    uint32_t tickstart = HAL_GetTick();
    uint32_t wait = Delay;

    /* Add a freq to guarantee minimum wait */
    if (wait < HAL_MAX_DELAY)
        wait += (uint32_t)(uwTickFreq);

    while ((HAL_GetTick() - tickstart) < wait)
    {
    }
}

从源码可见，该函数通过不断读取 HAL_GetTick() 的返回值并比较时间差来判断是否完成延时。而 HAL_GetTick() 的数值来源于一个全局变量 uwTick，该变量由 SysTick_Handler 定期调用 HAL_IncTick() 进行递增。

组件	作用	调用频率
SysTick Timer	提供系统节拍	通常为1ms
SysTick_Handler	中断服务函数	每1ms执行一次
HAL_IncTick()	递增 uwTick 计数器	由 SysTick_Handler 调用
HAL_GetTick()	获取当前系统时间（ms）	任意上下文可读取

一旦 SysTick 中断被禁用或未正确配置，uwTick 将停止增长，导致 HAL_Delay() 永远无法退出。

3. 常见错误场景与诊断流程

以下是典型的误用模式及对应的排查路径：

1. 未启用 SysTick 中断：检查 SystemCoreClockUpdate() 和 HAL_Init() 是否已调用；确认 SysTick_Config() 成功执行。
2. 在中断中调用 HAL_Delay()：由于中断上下文中禁止阻塞操作，且可能关闭全局中断，导致 HAL_IncTick() 无法执行。
3. 使用自定义定时器但未重定向 HAL_GetTick：若替换 SysTick 为 TIM2 等通用定时器，必须重写 HAL_GetTick() 或注册回调函数。
4. 高精度需求下仍使用 HAL_Delay(1)：1ms 精度无法满足微秒级控制，如驱动 WS2812B LED。

graph TD
    A[程序卡死于HAL_Delay] --> B{是否在中断中调用?}
    B -->|是| C[禁止在ISR中使用阻塞延时]
    B -->|否| D{SysTick是否正常工作?}
    D -->|否| E[检查NVIC_SetPriority & SysTick_Config]
    D -->|是| F{是否替换了SysTick?}
    F -->|是| G[重写HAL_GetTick或使用__weak]
    F -->|否| H[避免高频调用HAL_Delay]

4. 非阻塞高精度延时解决方案

为了实现在不阻塞系统前提下的高精度延时，推荐以下几种方案：

4.1 使用硬件定时器配合标志位（推荐用于裸机系统）

利用 STM32 的任意通用定时器（如 TIM3），配置为向上计数模式，设定周期后开启中断，在中断中置位完成标志。

// 初始化定时器
HAL_TIM_Base_Start_IT(&htim3);

// 设置延时时间（假设时钟为72MHz，预分频后为1MHz）
uint32_t us = 50;
__HAL_TIM_SET_AUTORELOAD(&htim3, us - 1);
timeout_flag = 0;
__HAL_TIM_CLEAR_FLAG(&htim3, TIM_FLAG_UPDATE);
HAL_TIM_Base_Start_IT(&htim3);

while(!timeout_flag); // 极短等待，可结合状态机避免阻塞
HAL_TIM_Base_Stop_IT(&htim3);

4.2 重定向 HAL_GetTick 到自定义定时器（适用于复杂系统迁移）

当需要保留 HAL_Delay() 接口但更换时间源时，可通过重定义 HAL_GetTick 函数：

__weak uint32_t HAL_GetTick(void)
{
    return custom_tick_counter; // 来自TIM6等独立定时器
}

需确保该定时器中断服务函数中定期执行 custom_tick_counter++;，频率建议为1ms。

4.3 结合 RTOS 实现任务级延时（适用于多任务环境）

在 FreeRTOS 或 ThreadX 等实时操作系统中，应使用 osDelay() 或 vTaskDelay() 替代 HAL_Delay()，释放 CPU 资源给其他任务。

#ifdef USE_FREERTOS
    vTaskDelay(pdMS_TO_TICKS(10)); // 非阻塞延时10ms
#else
    HAL_Delay(10);
#endif

4.4 微秒级精确延时：直接操作 DWT_CYCCNT（仅限 Cortex-M 处理器）

对于需要亚毫秒级精度的场合，可启用数据观察点单元（DWT）的循环计数器：

static inline void delay_us(uint32_t us)
{
    uint32_t start = DWT->CYCCNT;
    uint32_t cycles = us * (SystemCoreClock / 1000000);
    while ((DWT->CYCCNT - start) < cycles);
}

使用前需使能 DWT 和 DEMCR 寄存器：

CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;
DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk;
DWT->CYCCNT = 0;