Инженер — это не профессия, а состояние души

HAL_Delay() в основном цикле — самый быстрый способ написать код, который перестаёт реагировать на кнопки и события, пока ждёт. В статье — паттерн программных неблокирующих таймеров на HAL_GetTick() и антидребезг кнопки как конечный автомат поверх них, без прерываний и без аппаратных TIM.

Почему не HAL_Delay()

HAL_Delay(ms) — это блокирующий цикл, который крутится до истечения времени и не даёт выполняться ничему другому. Приемлемо в коде инициализации, но в основном цикле любая задержка означает, что опрос кнопок, чтение UART и прочая логика встают на паузу вместе с ней. Для проекта с несколькими параллельными задачами (мигание светодиодом раз в 500 мс, опрос кнопки каждый цикл, приём по UART) это быстро превращается в нерабочий код.

Программный таймер на HAL_GetTick()

HAL_GetTick() — счётчик миллисекунд, который HAL обновляет по прерыванию SysTick независимо от того, чем занят основной цикл. На его основе — минимальный неблокирующий таймер:

typedef struct {
    uint32_t start;
    uint32_t interval;
    bool running;
} SoftTimer_t;

static inline void SoftTimer_Start(SoftTimer_t *t, uint32_t interval_ms)
{
    t->start = HAL_GetTick();
    t->interval = interval_ms;
    t->running = true;
}

static inline bool SoftTimer_Elapsed(SoftTimer_t *t)
{
    if (!t->running) {
        return false;
    }
    if ((uint32_t)(HAL_GetTick() - t->start) >= t->interval) {
        t->running = false;
        return true;
    }
    return false;
}

Важная деталь — вычитание (uint32_t)(HAL_GetTick() - t->start), а не прямое сравнение HAL_GetTick() >= t->start + interval. HAL_GetTick() переполняется примерно раз в 49 дней (32-битный счётчик миллисекунд), и при прямом сравнении на переполнении таймер зависнет на неопределённое время. Вычитание двух uint32_t с переполнением корректно даёт беззнаковую арифметику по модулю 2³², так что разница остаётся верной даже когда HAL_GetTick() уже «перевалил через ноль», а start — ещё нет.

SoftTimer_Elapsed() одноразовый — сработав, таймер переходит в неактивное состояние (running = false), и для повторного срабатывания его нужно перезапустить явно. Это специально: периодические и одноразовые таймеры — разные сценарии использования, и неявный автоперезапуск внутри Elapsed() легко приводит к тихому дрейфу периода при долгих итерациях основного цикла.

Антидребезг кнопки как конечный автомат

Механическая кнопка при нажатии/отпускании даёт несколько коротких замыканий/размыканий контакта за единицы–десятки миллисекунд (дребезг) — наивное чтение GPIO в цикле даёт несколько ложных срабатываний на одно нажатие. Антидребезг — не «подождать N мс и считать стабильным» одной строкой, а состояние, которое нужно явно вести:

typedef enum { BTN_IDLE, BTN_DEBOUNCE, BTN_PRESSED, BTN_RELEASE_WAIT } ButtonState_t;

typedef struct {
    GPIO_TypeDef *port;
    uint16_t pin;
    ButtonState_t state;
    SoftTimer_t debounce_timer;
    bool pressed_event;
} Button_t;

#define BTN_DEBOUNCE_MS 30

void Button_Poll(Button_t *btn)
{
    GPIO_PinState raw = HAL_GPIO_ReadPin(btn->port, btn->pin);

    switch (btn->state) {
    case BTN_IDLE:
        if (raw == GPIO_PIN_RESET) {
            SoftTimer_Start(&btn->debounce_timer, BTN_DEBOUNCE_MS);
            btn->state = BTN_DEBOUNCE;
        }
        break;
    case BTN_DEBOUNCE:
        if (raw != GPIO_PIN_RESET) {
            btn->state = BTN_IDLE;
        } else if (SoftTimer_Elapsed(&btn->debounce_timer)) {
            btn->state = BTN_PRESSED;
            btn->pressed_event = true;
        }
        break;
    case BTN_PRESSED:
        if (raw != GPIO_PIN_RESET) {
            btn->state = BTN_RELEASE_WAIT;
            SoftTimer_Start(&btn->debounce_timer, BTN_DEBOUNCE_MS);
        }
        break;
    case BTN_RELEASE_WAIT:
        if (raw == GPIO_PIN_RESET) {
            btn->state = BTN_PRESSED;
        } else if (SoftTimer_Elapsed(&btn->debounce_timer)) {
            btn->state = BTN_IDLE;
        }
        break;
    }
}

Логика предполагает вход с подтяжкой к питанию и кнопку, замыкающую на GND (активный уровень — low, GPIO_PIN_RESET). Четыре состояния:

  • IDLE — кнопка отпущена, ждём первого признака нажатия.
  • DEBOUNCE — обнаружен низкий уровень, запущен таймер; если уровень вернулся в high раньше истечения таймера — это был дребезг или случайная наводка, возврат в IDLE без события.
  • PRESSED — таймер истёк при стабильно низком уровне, нажатие засчитано (pressed_event = true), ждём отпускания.
  • RELEASE_WAIT — аналогичная проверка на дребезг при отпускании, прежде чем вернуться в IDLE.

Флаг pressed_event читается и сбрасывается отдельной функцией (Button_WasPressed()), а не проверяется напрямую — это разделяет «обнаружение факта нажатия» внутри автомата и «использование события» в остальном коде, и гарантирует, что одно нажатие не будет обработано дважды разными частями программы.

Проверка синтаксиса

Код выше (вместе с инициализацией Button_t и основным циклом) собран локально через arm-none-eabi-gcc -fsyntax-only -mcpu=cortex-m3 -mthumb с минимальным набором заглушек HAL (HAL_GetTick, HAL_GPIO_ReadPin, типы GPIO_TypeDef/GPIO_PinState) — ошибок компиляции нет. Заглушки покрывают только сигнатуры, используемые в примере, это не замена реальной HAL-библиотеки из STM32CubeIDE. На плате не проверялось — перед использованием прогнать на реальном железе и уточнить время дребезга для конкретных кнопок (30 мс — ориентир, не универсальная константа).

Итог

Неблокирующие программные таймеры на HAL_GetTick() заменяют HAL_Delay() там, где в основном цикле есть несколько параллельных задач. Антидребезг кнопки — не задержка, а конечный автомат с несколькими состояниями, который одинаково корректно обрабатывает и дребезг при нажатии, и дребезг при отпускании. Подход не годится, когда реакция на кнопку должна быть мгновенной и не терпит задержки основного цикла — для этого нужны аппаратные прерывания по фронту (EXTI), а не опрос в for(;;).

← Все статьи раздела «Программирование»