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

Приём по UART с длиной пакета заранее неизвестна (например, RS-485 с переменной длиной кадра) — частая задача, где прерывание по каждому байту съедает процессорное время на постоянные входы в обработчик. DMA с определением конца пакета по IDLE line решает это без потери данных и почти без нагрузки на CPU.

Почему не HAL_UART_Receive(..., size, timeout)

Блокирующий приём с фиксированным размером годится только тогда, когда длина пакета известна заранее и постоянна. Для протоколов с переменной длиной кадра (Modbus RTU, NMEA, произвольный ASCII-протокол) — либо нужно читать по одному байту и разбирать границы кадра вручную в прерывании, либо использовать механизм HAL, который сам определяет паузу на линии (IDLE) как признак конца пакета.

IDLE line detection + DMA

HAL_UARTEx_ReceiveToIdle_DMA() запускает приём в кольцевой DMA-буфер и вызывает HAL_UARTEx_RxEventCallback() в трёх случаях: при заполнении половины буфера, при заполнении буфера целиком и — что здесь главное — при обнаружении паузы на линии (IDLE, определённое число битовых тактов без передачи). Во всех трёх случаях в колбэк передаётся Size — количество байт, реально принятых DMA с начала буфера на момент вызова.

#define DMA_RX_BUF_SIZE 64U

static uint8_t dma_rx_buf[DMA_RX_BUF_SIZE];
static uint16_t dma_rx_last_pos = 0;
static UART_HandleTypeDef huart1;

static void UART_StartReceive(void)
{
    dma_rx_last_pos = 0;
    HAL_UARTEx_ReceiveToIdle_DMA(&huart1, dma_rx_buf, DMA_RX_BUF_SIZE);
}

DMA-буфер используется по кругу (как только доходит до конца — пишет заново с начала), поэтому Size может быть как больше, так и меньше предыдущего значения — это означает, что DMA перешёл через конец буфера. Копирование новых байт в кольцевой буфер приложения должно учитывать оба случая:

void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)
{
    if (huart->Instance != huart1.Instance) {
        return;
    }

    if (Size > dma_rx_last_pos) {
        for (uint16_t i = dma_rx_last_pos; i < Size; i++) {
            Ring_Push(dma_rx_buf[i]);
        }
    } else if (Size < dma_rx_last_pos) {
        for (uint16_t i = dma_rx_last_pos; i < DMA_RX_BUF_SIZE; i++) {
            Ring_Push(dma_rx_buf[i]);
        }
        for (uint16_t i = 0; i < Size; i++) {
            Ring_Push(dma_rx_buf[i]);
        }
    }
    dma_rx_last_pos = Size;
}

Разбор на две ветки — не защита от гипотетического случая, а штатная ситуация: при непрерывном потоке данных DMA рано или поздно переходит через конец буфера именно между вызовами колбэка, и код обязан правильно «дотянуть» хвост старого прохода и начало нового.

Кольцевой буфер приложения

DMA-буфер (dma_rx_buf) — технический, фиксированного размера и перезаписывается DMA сам. Данные, которые должна обработать логика приложения, копируются в отдельный кольцевой буфер побольше, из которого их читает основной цикл в своём темпе:

#define RING_BUF_SIZE 256U

static uint8_t ring_buf[RING_BUF_SIZE];
static volatile uint16_t ring_head = 0;
static volatile uint16_t ring_tail = 0;

static void Ring_Push(uint8_t byte)
{
    uint16_t next = (uint16_t)((ring_head + 1U) % RING_BUF_SIZE);
    if (next == ring_tail) {
        ring_tail = (uint16_t)((ring_tail + 1U) % RING_BUF_SIZE);
    }
    ring_buf[ring_head] = byte;
    ring_head = next;
}

int Ring_Pop(uint8_t *out)
{
    if (ring_tail == ring_head) {
        return 0;
    }
    *out = ring_buf[ring_tail];
    ring_tail = (uint16_t)((ring_tail + 1U) % RING_BUF_SIZE);
    return 1;
}

ring_head/ring_tail объявлены volatile — колбэк вызывается в контексте прерывания DMA, а читает буфер основной цикл; без volatile компилятор формально вправе закэшировать значение индекса в регистре и не увидеть изменение, сделанное в прерывании.

Типичные ошибки

  • Перезапуск приёма после каждого кадра командой HAL_UART_Receive вместо постоянного ReceiveToIdle_DMA. Между остановкой одного приёма и стартом следующего есть окно, в которое могут прийти байты следующего кадра — они будут потеряны.
  • Обработка кадра прямо в HAL_UARTEx_RxEventCallback. Колбэк выполняется в контексте прерывания — долгая обработка там держит прерывания замаскированными. Колбэк должен только переливать байты в кольцевой буфер, разбор — в основном цикле.
  • Не учтён переход DMA через конец буфера — без неё часть байт при каждом обороте DMA молча пропадает, и баг проявляется только на длинных сессиях.

Итог

HAL_UARTEx_ReceiveToIdle_DMA с круговым DMA-буфером и промежуточным кольцевым буфером приложения даёт приём кадров переменной длины без постоянного участия CPU. Код полагается на то, что разбор протокола идёт отдельно, в основном цикле — на примере Modbus RTU — в следующей статье серии.

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