Приём по 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 — в следующей статье серии.