STM32 串口:DMA 与不定长接收

中断模式让 CPU 不用再卡在接收上,但还剩两个问题:每来一个字节就要打断 CPU 一次;每条指令的长度写死成 2 个字节,多发或少发一个,后面的指令就全部错位。DMA 解决前一个,串口空闲中断解决后一个,HAL 把两者合进了一个函数 HAL_UARTEx_ReceiveToIdle_DMA。

速查:从中断模式改过来要动哪几处

位置 改什么
CubeMX USART2 → DMA Settings → Add,加 USART2_TX 和 USART2_RX 两个通道,参数用默认
接收数组 开大一点,比如 uint8_t receiveData[50];
开启接收 HAL_UART_Receive_IT(&huart2, receiveData, 2) 换成 HAL_UARTEx_ReceiveToIdle_DMA(&huart2, receiveData, sizeof(receiveData))
回调 HAL_UART_RxCpltCallback 换成 HAL_UARTEx_RxEventCallback,多一个参数 Size
发送 _IT 换成 _DMA,长度填 Size
过半中断 每次开启接收后紧跟一句 __HAL_DMA_DISABLE_IT(&hdma_usart2_rx, DMA_IT_HT);

两个可以组合的选择

HAL 的串口接收函数是两个选择拼起来的:谁来搬数据,以及怎么判断一条消息收完了。

阻塞 中断 DMA
定长:收满 N 个字节 HAL_UART_Receive HAL_UART_Receive_IT HAL_UART_Receive_DMA
不定长:线路空闲 HAL_UARTEx_ReceiveToIdle HAL_UARTEx_ReceiveToIdle_IT HAL_UARTEx_ReceiveToIdle_DMA

定长的中断版和 DMA 版收完调 HAL_UART_RxCpltCallback,不定长的调 HAL_UARTEx_RxEventCallback。两个阻塞版没有回调,函数返回时就收完了。

DMA:让硬件去搬数据

中断模式下,每来一个字节,串口触发一次“接收数据寄存器非空”中断,CPU 回来把它从 DR 搬进数组。DMA(Direct Memory Access)是芯片里专门搬数据的硬件,告诉它从哪搬到哪、搬多少,它就在后台自己搬,CPU 不用管。

以收一次 Hello(5 个字节)为例:

CPU 被叫回来几次 换成 40 个字节
中断模式 5 次,每个字节一次 40 次
DMA + 空闲中断 1 次,线路空闲时 还是 1 次

中断的次数从跟着字节数走,变成了跟着消息条数走,数据越长省得越多。

CubeMX 里点 Add 选好通道以后,参数会自动填上。F103 上 USART2_TX 用的是 DMA1 Channel 7,USART2_RX 是 Channel 6。几个参数的意思:

  • Direction:TX 是 Memory To Peripheral(数组 → DR),RX 是 Peripheral To Memory
  • Increment Address:外设端不勾,DR 只有一个,地址不变;内存端勾上,每搬一个字节往数组后面挪一格
  • Data Width:Byte,一次搬 1 个字节
  • Mode:Normal,搬完就停;Circular 是循环模式,这里用不到

用了 DMA 也不是完全没有中断。DMA 搬完或者线路空闲时还是要靠中断通知 CPU,回调照样在中断里执行,所以里面照样不能调 HAL_Delay。

空闲中断:怎么知道一条消息收完了

串口助手点一次发送,几个字节是紧挨着发出去的,发完 RX 线就停在高电平不动了。串口硬件发现线路空闲了大约一个字节的时间,就置起 IDLE 标志,触发空闲中断。这个条件跟收了几个字节无关,所以可以把“线路空闲”当成一条消息的结尾。

HAL_UARTEx_ReceiveToIdle_DMA(&huart2, receiveData, sizeof(receiveData));

第三个参数是最多收多少,不是要收多少。receiveData 是 50 个字节,sizeof 得到的就是 50。线路一空闲就提前结束;如果一直没空闲、50 个字节收满了,也会结束,防止写出数组。

收完以后 HAL 调用的回调是:

void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)

Size 由 HAL 填进来,是这次实际收到的字节数。发 R1 时是 2,发 Hello 时是 5。回显的时候长度就用它,收到几个回几个。

两个回调都在,HAL 调哪个

旧的 RxCpltCallback 和新的 RxEventCallback 同时写在文件里时,执行哪个取决于开启接收时调的是哪个函数。HAL 会在串口句柄里记下接收模式:

// HAL_UART_Receive_DMA 里
huart->ReceptionType = HAL_UART_RECEPTION_STANDARD;

// HAL_UARTEx_ReceiveToIdle_DMA 里
huart->ReceptionType = HAL_UART_RECEPTION_TOIDLE;

DMA 搬完时,stm32f1xx_hal_uart.c 里的 UART_DMAReceiveCplt 按这个标记分流(省略了注册回调的分支):

if (huart->ReceptionType == HAL_UART_RECEPTION_TOIDLE)
{
  HAL_UARTEx_RxEventCallback(huart, huart->RxXferSize);
}
else
{
  HAL_UART_RxCpltCallback(huart);
}

换成 ReceiveToIdle 以后,旧回调不会再被调用,原来写在里面的控灯代码也就不再执行了,要搬到新回调里。

代码

/* USER CODE BEGIN PV */
uint8_t receiveData[50];
/* USER CODE END PV */

/* USER CODE BEGIN 2 */
HAL_UARTEx_ReceiveToIdle_DMA(&huart2, receiveData, sizeof(receiveData));
__HAL_DMA_DISABLE_IT(&hdma_usart2_rx, DMA_IT_HT);
/* USER CODE END 2 */

回调写在 USER CODE BEGIN 0 里:

void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)
{
  if (huart == &huart2)
  {
    HAL_UART_Transmit_DMA(&huart2, receiveData, Size);   // 收到几个回几个

    if (Size == 2) {                                     // 长度不对的指令不处理
      GPIO_PinState State = GPIO_PIN_SET;                // 高电平 = 亮
      if (receiveData[1] == '0') {
        State = GPIO_PIN_RESET;                          // 低电平 = 灭
      }
      if (receiveData[0] == 'B') {
        HAL_GPIO_WritePin(LED_BLUE_GPIO_Port, LED_BLUE_Pin, State);
      } else if (receiveData[0] == 'G') {
        HAL_GPIO_WritePin(LED_GREEN_GPIO_Port, LED_GREEN_Pin, State);
      } else if (receiveData[0] == 'R') {
        HAL_GPIO_WritePin(LED_RED_GPIO_Port, LED_RED_Pin, State);
      }
    }

    HAL_UARTEx_ReceiveToIdle_DMA(&huart2, receiveData, sizeof(receiveData));
    __HAL_DMA_DISABLE_IT(&hdma_usart2_rx, DMA_IT_HT);
  }
}

开头判断 huart == &huart2:huart 是 HAL 传进来的参数,表示这次是哪个串口触发的,huart2 是全局的 USART2 句柄。工程里只用一个串口时不判断也能跑,但所有串口共用这一个回调,多加一个串口就会串。

重新开启接收要放在 if 外面

HAL 每收完一条就停止接收,所以回调最后要重新开启。这一句不能挪进 if (Size == 2) 里:

发 B1 → Size = 2 → 进 if → 控灯,重新开启接收
发 B  → Size = 1 → 不进 if → 接收没有重新开启
发 B1 → 接收已经关了,DMA 不搬,回调不会再进来

只要发错一次,串口就再也收不到东西,只能复位。控灯跟这条消息合不合法有关,放在 if 里;重新开启接收跟这条消息无关,无论如何都要做。

传输过半中断

DMA 通道除了传输完成中断,还有一个传输过半中断(HT,Half Transfer),搬到一半时触发。在 ToIdle 模式下,HAL 把它也接到了 RxEventCallback 上,Size 传的是缓冲区长度的一半(UART_DMARxHalfCplt 里):

HAL_UARTEx_RxEventCallback(huart, huart->RxXferSize / 2U);

缓冲区是 50 个字节的话,一条消息只要超过 25 个字节,收到第 25 个时就会多进一次回调,这时消息只收了一半。缓冲区开得大、平时发的指令又短,就碰不到这个问题,所以测试时很容易漏掉。

关掉它用的是一个宏:

__HAL_DMA_DISABLE_IT(&hdma_usart2_rx, DMA_IT_HT);

只在 main 里关一次是不够的。ReceiveToIdle_DMA 内部会调用 HAL_DMA_Start_IT,而它每次启动都会把 HT 重新打开(stm32f1xx_hal_dma.c):

if(NULL != hdma->XferHalfCpltCallback)
{
  /* Enable the Half transfer complete interrupt as well */
  __HAL_DMA_ENABLE_IT(hdma, (DMA_IT_TC | DMA_IT_HT | DMA_IT_TE));
}

所以每次调用 ReceiveToIdle_DMA 之后都要紧跟着关一次,main 里一处,回调里一处。

踩坑

if (huart2 == &huart2):参数名 huart 多打了一个 2,变成拿结构体和自己的地址比,编译直接报错。

HAL_UART_Transmit(&huart2, receiveData, Size, Size):阻塞版发送的第 4 个参数是超时时间(毫秒),填 Size 等于“最多等两三毫秒”,跟要发的内容无关。这里应该用 HAL_UART_Transmit_DMA,它只有 3 个参数。

在板子上验证

不关过半中断,发 30 个字符只回来 25 个

把两处 __HAL_DMA_DISABLE_IT 都注释掉,一次发 30 个字符。

结果:只回来前 25 个字符。

115200 波特率下收发一个字节大约 0.087 ms。按时间顺序:

收到第 25 个字节:过半中断,第一次进回调,Size = 25
  Transmit_DMA(25)      开始回显前 25 个,要发 25 × 0.087 ≈ 2.2 ms
  ReceiveToIdle_DMA     这次接收其实还没结束,返回 HAL_BUSY,什么也没做

剩下 5 个到齐,线路空闲:空闲中断,第二次进回调,Size = 30
  Transmit_DMA(30)      离上一步才 0.5 ms 左右,前 25 个还在发,返回 HAL_BUSY,被丢掉

两个函数开头都先检查状态,不空闲就直接返回 HAL_BUSY:

if (huart->RxState == HAL_UART_STATE_READY)   // ReceiveToIdle_DMA
if (huart->gState  == HAL_UART_STATE_READY)   // Transmit_DMA

代码里没有接住返回值,所以失败了什么也看不出来。需要知道有没有发出去时可以判断:

if (HAL_UART_Transmit_DMA(&huart2, receiveData, Size) != HAL_OK) {
  // 没发出去
}

只发一个 B,灯听的是上一条

先不加 Size == 2 的判断。

先发 B0,再只发一个 B:蓝灯保持灭。前一条第 2 个字节不是 '0' 时,再只发一个 B:蓝灯亮了。

单独一个 B 没说开还是关,但代码照样去读 receiveData[1]。这次只收了 1 个字节,第 1 格没被覆盖,里面是上一条消息剩下的。代码里只有 '0' 算关,其它字符都算开,所以同一个 B 亮不亮,由上一条消息决定。

加上 if (Size == 2) 以后:B1 亮,B 和 B11 都被忽略,灯不变。

多发一个字节不再错位

先发 R11,再发 B1。

结果:B1 正常处理,没有错位。

定长接收时多出来的那个 1 会留在缓冲区里和下一条拼在一起。现在每条消息都从 receiveData[0] 开始存,消息之间互不影响。

还没解决的问题

Size == 2 只检查了长度。X1 长度对,但不会命中任何一个分支;B5 也能通过,而且 '5' 不是 '0',会被当成“开”。要可靠地区分合法指令,得约定数据包格式,比如固定的包头、长度字段和校验,见蓝牙透传与数据包解析。

另外,回显和接收用的是同一个 receiveData。回调里刚开始用 DMA 发送,接收就已经重新开启了,如果下一条消息紧接着到来,从代码上看会在发送还没结束时覆盖数组。指令间隔较长时碰不到这个问题,要连续收发时就得给发送单独准备一块缓冲区。