HAL и регистры: первый проект — мигание светодиодом без Arduino-абстракций

Введение

С настроенным тулчейном (статья 352) разберём детальнее устройство простейшего STM32-проекта — мигание светодиодом — углубляясь в то, что происходит «под капотом» HAL-вызовов, и явно связывая каждый вызов с конкретными регистрами периферии, упомянутыми обзорно в статье 351.

Концепция

Каждый GPIO-порт STM32 (GPIOA, GPIOB и так далее) управляется через набор регистров: MODER (режим работы каждого пина — вход, выход, альтернативная функция, аналоговый), OTYPER (тип выхода — push-pull или open-drain), OSPEEDR (скорость переключения), PUPDR (подтягивающие резисторы), ODR (текущее выводимое значение для пинов в режиме выхода) и IDR (считанное значение для пинов в режиме входа). HAL-функции (HAL_GPIO_Init(), HAL_GPIO_WritePin()) — удобные обёртки, выполняющие соответствующие битовые операции над этими регистрами на основе переданной структуры конфигурации, не добавляя существенных накладных расходов по сравнению с прямой записью в регистры (HAL для GPIO обычно компилируется в столь же эффективный код, как и ручная работа с регистрами, благодаря инлайнингу компилятора).

Пример кода: HAL и регистры

// main.c — полный, прокомментированный пример мигания светодиодом через HAL
#include "stm32f4xx_hal.h"

void SystemClock_Config(void); // сгенерировано CubeMX — настройка тактовой частоты системы

void GPIO_Init(void)
{
    __HAL_RCC_GPIOA_CLK_ENABLE(); // RCC->AHB1ENR |= RCC_AHB1ENR_GPIOAEN; — макрос разворачивается именно в это

    GPIO_InitTypeDef gpio = {0};
    gpio.Pin = GPIO_PIN_5;
    gpio.Mode = GPIO_MODE_OUTPUT_PP;    // MODER: установит биты для пина 5 в "01" (выход)
    gpio.Pull = GPIO_NOPULL;             // PUPDR: оставит биты для пина 5 в "00" (без подтяжки)
    gpio.Speed = GPIO_SPEED_FREQ_LOW;    // OSPEEDR: установит биты для пина 5 в "00" (низкая скорость)
    HAL_GPIO_Init(GPIOA, &gpio);
}

int main(void)
{
    HAL_Init();           // настройка SysTick-таймера для HAL_Delay(), сброс некоторой периферии
    SystemClock_Config();  // настройка PLL и итоговой тактовой частоты ядра
    GPIO_Init();

    while (1) {
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);   // ODR |= (1 << 5);
        HAL_Delay(500);
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET); // ODR &= ~(1 << 5);
        HAL_Delay(500);
    }
}

// Эквивалент HAL_GPIO_WritePin через прямую работу с регистром — для понимания внутренней реализации
static inline void setPinDirect(GPIO_TypeDef *port, uint16_t pin, int high)
{
    if (high) {
        port->BSRR = pin;            // Bit Set Reset Register — установка пина в 1 (быстрее, чем ODR |=)
    } else {
        port->BSRR = (uint32_t)pin << 16; // верхние 16 бит BSRR — сброс соответствующего пина в 0
    }
}

Пояснения к коду

Комментарии внутри GPIO_Init() явно показывают соответствие каждого поля структуры GPIO_InitTypeDef конкретному регистру и конкретным битам внутри него — это связывает удобный, высокоуровневый HAL API с низкоуровневой реальностью регистров, упомянутой в статье 351, без необходимости программисту вручную считать битовые сдвиги при обычной работе с HAL. setPinDirect() показывает альтернативный, более эффективный способ изменения состояния пина через регистр BSRR (Bit Set Reset Register) — в отличие от обычного чтения-изменения-записи регистра ODR (что теоретически может быть прервано другим кодом между чтением и записью, изменяющим тот же регистр), запись в BSRR атомарна на аппаратном уровне и точно указывает, какой именно бит установить или сбросить, без риска гонки данных при одновременном изменении других пинов того же порта.

Подводные камни

Использование ODR |= .../ODR &= ~... (чтение-изменение-запись) вместо атомарной записи в BSRR в коде, выполняющемся в контексте обработчика прерывания, который может прервать основной поток выполнения именно между чтением и записью регистра ODR — если основной код в этот момент также пытается изменить другой пин того же GPIO-порта, возможна гонка данных, теряющая одно из двух изменений; для кода, работающего в прерываниях или просто ради надёжности, BSRR — предпочтительный, атомарный способ изменения состояния пина.
Забытый вызов __HAL_RCC_GPIOA_CLK_ENABLE() перед настройкой и использованием порта — без включения тактирования конкретного GPIO-порта весь последующий код, обращающийся к его регистрам, либо не будет иметь видимого эффекта (запись в регистры периферии без тактирования просто игнорируется аппаратно), либо в некоторых случаях вызовет ошибку доступа к памяти — это одна из самых частых, обманчиво простых ошибок при переходе от Arduino (где это скрыто) к HAL/bare-metal STM32-разработке.
Полное отсутствие вызова SystemClock_Config() или его некорректная настройка — без правильной настройки системной тактовой частоты микроконтроллер обычно продолжает работать на значительно более низкой, «заводской» частоте после сброса (обычно от внутреннего, не самого точного генератора), что делает все расчёты задержек через HAL_Delay() (опирающиеся на ожидаемую частоту SysTick) неверными — реальное время задержки будет отличаться от ожидаемого пропорционально разнице между настроенной и фактической тактовой частотой.
Игнорирование того, что некоторые пины STM32 после сброса по умолчанию настроены в режим, отличный от ожидаемого (например, аналоговый вход, а не обычный GPIO) — особенно для пинов, совмещающих несколько функций (ADC, альтернативные функции периферии UART/SPI), явная настройка через GPIO_InitTypeDef.Mode обязательна для перевода пина в нужный, ожидаемый режим работы, и нельзя предполагать, что пин уже находится в подходящем для конкретной задачи режиме просто потому, что это кажется «логичным выбором по умолчанию».