记录一次对STM32G4串口硬件FIFO的调试
前言:通常我们使用串口接收多字节数据会使用中断和DMA两种方式。使用中断方式,每接收到一个字节就会触发一次中断,我们可以在中断函数里将接收到的这一字节保存在内存中然后等待其他程序处理,也可以直接在中断函数里处理。使用DMA方式,需要事先开辟一块内存,每当接收到一个字节,DMA会自动将数据保存在开辟的内存中而不需要CPU的参与。
中断方式的优点是可以在第一时间知道串口接收到了新数据,在一些对实时性要求特别高的情况下占优。而DMA方式则需要程序周期性的轮训接收内存,看看有没有收到新数据。但是中断方式每接收到一个字节都需要CPU去处理,在波特率比较高、数据量比较大的场合下会频繁进入中断,严重影响效率,甚至会干扰到其他程序的运行,这个时候使用DMA方式会更加合理。
现在,针对波特率高、数据量大的情况,又多了一种选择,那就是使用串口的硬件FIFO功能。串口硬件FIFO只有ST后面出的型号才有,比如H7、G4系列等,F1、F4系列应该是没有这个功能的。之前的中断方式,每收到一个字节都会触发一次中断,而使用了硬件FIFO,可以在收到n个字节后才触发一次中断,然后在中断函数里一次性地取出这n个字节。在连续接收大量数据的情况下可以大大降低进入中断的频率,提高效率。这里也多嘴一句,有了硬件FIFO不等于不再需要软件FIFO!!!
一、功能配置
这里使用CubeMX软件配置,使用硬件FIFO的前提是先正确配置好串口中断接收的功能。
相比普通的功能,这里多了三个选项:
1、Fifo Mode
这里选择使能。
2、Txfifo Threshold
发送FIFO的阈值,因为这次仅调试了接收FIFO,没用到发送,所以选择默认值。后续可能会再出一篇关于发送的文章。
3、Rxfifo Threshold
接收FIFO的阈值,这里选择一半深度。
说明:
- FIFO的深度是多少?配置选项只说1/8、1/4、1/2、3/4、7/8这些。个人经过调试,推测深度是8字节,当然确切来讲不能说是8字节,因为位宽不一定是8位(数据字长、有无奇偶校验),应该说FIFO可以保存8次接收数据,再加上RDR寄存器也可以保存一次接收数据,所以最多可以保存9次接收数据而不溢出。
- 阈值是干什么的,一般配成多少。这里的阈值意味着当我的接收FIFO收到n个数据了就可以产生一次中断。比如我设为1/2并且使能了相应的RXFT中断,那么每收到4次(这里的4就是8的1/2,后文所有的4都是这么来的,后面不再解释)数据就会产生一次RXFT中断。个人觉得阈值设为一半左右的深度比较好,设的太小了起不到降低CPU利用率的效果,设置的太大了容易溢出。要注意,这里设置的阈值仅仅影响中断的触发,并不会改变FIFO能保存多少数据。
然后我们生成工程即可。
二、硬件FIFO的使用
1、配置正常的中断接收
我们在初始化过程中加上这一句:
__HAL_UART_ENABLE_IT(&huart1, UART_IT_RXNE);
然后编写中断函数:
void USART1_IRQHandler(void)
{
/* USER CODE BEGIN USART1_IRQn 0 */
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET);
USART1->TDR = USART1->RDR;
/* USER CODE END USART1_IRQn 0 */
HAL_UART_IRQHandler(&huart1);
/* USER CODE BEGIN USART1_IRQn 1 */
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET);
/* USER CODE END USART1_IRQn 1 */
}
再用串口助手发送"12345\r\n",观看逻辑分析仪抓到的波形:
通道0连接的是PA0,通道4连接的是RX,通道3连接的是TX。发现串口每接收到一个数据就进入一次中断,并且把接收到的数据原封不动的发送出去。符合我们之前的设想。
2、FIFO的运行机制探究
下面,我们把RXNE中断改为RXFT中断:
// __HAL_UART_ENABLE_IT(&huart1, UART_IT_RXNE);
__HAL_UART_ENABLE_IT(&huart1, UART_IT_RXFT);
修改中断函数:
uint8_t rxBuf[32];
uint8_t rxCnt;
void USART1_IRQHandler(void)
{
/* USER CODE BEGIN USART1_IRQn 0 */
if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFT))
{
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET);
for(int i = 0; i < 8; i ++)
{
if(!__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFNE))
{
break;
}
rxBuf[rxCnt++] = USART1->RDR;
}
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET);
}
/* USER CODE END USART1_IRQn 0 */
HAL_UART_IRQHandler(&huart1);
/* USER CODE BEGIN USART1_IRQn 1 */
/* USER CODE END USART1_IRQn 1 */
}
并且在主循环里加上这一段:(仅用来验证FIFO功能,切勿用于其他用途)
void softDelay()
{
for(int i = 0; i < 30000; i ++)
{}
}
int main(void)
{
init();
while(1)
{
if(rxCnt)
{
lastRxCnt = rxCnt;
softDelay();
if(rxCnt == lastRxCnt)
{
HAL_UART_Transmit(&huart1, rxBuf, rxCnt, 10);
lastRxCnt = rxCnt = 0;
}
}
}
}
然后使用串口助手同样发送"12345\r\n",观看逻辑分析仪抓到的波形:
神奇的事情发送了,串口居然只返回了"1234",丢了3字节,而且我们发现仅在接收到第4个字节的时候进入了一次中断,这是为什么?
正如我们前面分析的,因为Rxfifo Threshold设置为1/2的深度,所以在第4次接收到数据时触发了一次RXFT中断,但后面的"5\r\n"只有三字节,不足以再次触发RXFT中断。而进不了中断就没有从FIFO中取出数据,因此最终只返回了"1234",剩下的"5\r\n"依旧保存在FIFO中。那么如何证明?
在现有基础上,我们再次发送"abcdefg\r\n",观看逻辑分析仪抓到的波形:
我们发现当接收完"a"的时候进入了一次中断,之后每收到4次数据就进入一次中断。而串口返还的数据是"5\r\nabcdefg\r\n",到了这里,相信大家都明白是怎么回事了吧。
没错,只有在FIFO存满4字节才会触发一次RXFT中断,不足4字节会保存下来,直到再一次存满4字节。
看到这里可能有人要吐槽了,这功能也太鸡肋了吧。先别着急,后面有办法解决。
3、如何正确的使用FIFO进行数据接收
不知道大家是否还记得空闲中断,对,就是用于DMA接收不定长数据用到的那个空闲中断。有了它,我们就可以把FIFO中不足4字节的数据给取出来了。
不过这里建议使用新的超时功能而不是idle。因为我们不知道发送方在发送多个字节时,中间的时间间隔能不能保持在很小,因为发送方有可能是USB转串口芯片、有可能是单片机硬件串口,甚至可能是IO模拟出来的串口。新功能RTO支持手动配置超时时间,而idle不行。
然后我们修改初始化代码:
__HAL_UART_ENABLE_IT(&huart1, UART_IT_RXFT);
HAL_UART_ReceiverTimeout_Config(&huart1, 2);
HAL_UART_EnableReceiverTimeout(&huart1);
__HAL_UART_ENABLE_IT(&huart1, UART_IT_RTO);
修改中断函数:
void USART1_IRQHandler(void)
{
/* USER CODE BEGIN USART1_IRQn 0 */
if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RTOF))
{
__HAL_UART_CLEAR_FLAG(&huart1, UART_CLEAR_RTOF);
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_SET);
for(int i = 0; i < 8; i ++)
{
if(!__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFNE))
{
break;
}
rxBuf[rxCnt++] = USART1->RDR;
}
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_RESET);
}
if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFT))
{
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET);
for(int i = 0; i < 8; i ++)
{
if(!__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFNE))
{
break;
}
rxBuf[rxCnt++] = USART1->RDR;
}
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET);
}
/* USER CODE END USART1_IRQn 0 */
HAL_UART_IRQHandler(&huart1);
/* USER CODE BEGIN USART1_IRQn 1 */
/* USER CODE END USART1_IRQn 1 */
}
到了这里,基本的功能就已经实现了,如果不想继续深究,看到这边就可以了,后面我会分享自己的debug经历以及疑问。
问题1: 之前的代码没有手动清除RTOF标志位,导致HAL库自带的HAL_UART_IRQHandler(&huart1);
函数将 RXFT 中断使能给清除了。
问题代码:
void USART1_IRQHandler(void)
{
/* USER CODE BEGIN USART1_IRQn 0 */
if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFT))
{
SET_TEST0;
for(int i = 0; i < 8; i ++)
{
if(!__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFNE))
{
break;
}
rxBuf[rxCnt++] = USART1->RDR;
}
RESET_TEST0;
}
if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RTOF))
{
//__HAL_UART_CLEAR_FLAG(&huart1, UART_CLEAR_RTOF); 之前没写这句
SET_TEST2;
for(int i = 0; i < 8; i ++)
{
if(!__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFNE))
{
break;
}
rxBuf[rxCnt++] = USART1->RDR;
}
RESET_TEST2;
}
/* USER CODE END USART1_IRQn 0 */
HAL_UART_IRQHandler(&huart1);
/* USER CODE BEGIN USART1_IRQn 1 */
/* USER CODE END USART1_IRQn 1 */
}
结果导致一次性接收不超过9字节能正常接收,超过9字节只能接收前9字节:
问题2: 如果一次性接收到的数据刚好是4的倍数,那么最后一轮数据发完触发的是RTO中断还是RXFT中断还是都有?
经过多次验证,接收完最后一个数据后只能产生一个中断,如果先判断有没有产生RTO标志就不会再处理RXFT的内容(但前提是RTOR寄存器的RTO是0,不然最后只可能是RXFT中断),如果先判断有没有产生RXFT标志就不会再处理RTO的内容。
先判断RTO且RTOR寄存器的RTO是0的例子:
void USART1_IRQHandler(void)
{
/* USER CODE BEGIN USART1_IRQn 0 */
if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RTOF))
{
__HAL_UART_CLEAR_FLAG(&huart1, UART_CLEAR_RTOF);
SET_TEST2;
for(int i = 0; i < 8; i ++)
{
if(!__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFNE))
{
break;
}
rxBuf[rxCnt++] = USART1->RDR;
}
RESET_TEST2;
}
if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFT))
{
SET_TEST0;
for(int i = 0; i < 8; i ++)
{
if(!__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFNE))
{
break;
}
rxBuf[rxCnt++] = USART1->RDR;
}
RESET_TEST0;
}
/* USER CODE END USART1_IRQn 0 */
HAL_UART_IRQHandler(&huart1);
/* USER CODE BEGIN USART1_IRQn 1 */
/* USER CODE END USART1_IRQn 1 */
}
先判断RXFT的例子:
void USART1_IRQHandler(void)
{
/* USER CODE BEGIN USART1_IRQn 0 */
if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFT))
{
SET_TEST0;
for(int i = 0; i < 8; i ++)
{
if(!__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFNE))
{
break;
}
rxBuf[rxCnt++] = USART1->RDR;
}
RESET_TEST0;
}
if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RTOF))
{
__HAL_UART_CLEAR_FLAG(&huart1, UART_CLEAR_RTOF);
SET_TEST2;
for(int i = 0; i < 8; i ++)
{
if(!__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXFNE))
{
break;
}
rxBuf[rxCnt++] = USART1->RDR;
}
RESET_TEST2;
}
/* USER CODE END USART1_IRQn 0 */
HAL_UART_IRQHandler(&huart1);
/* USER CODE BEGIN USART1_IRQn 1 */
/* USER CODE END USART1_IRQn 1 */
}
这个问题仅会出现在字节数刚刚好是4的倍数的情况,如果不是则两种代码的结果都是一样的。或许ST是有意这么设计的,防止最后出现两次中断,还是说我哪里没有考虑到,如果有朋友能解释一下,鄙人不胜感激。
三、总结
随着我们工作、学习的不断深入,会接触到越来越高级的芯片、越来越复杂的外设功能,不再像以前那样随便看两篇教程、看两集视频、复制一段代码就能调通,即使是使用CubeMX加HAL库也不会那么容易。往后需要我们自己熟读手册,了解每一位寄存器的作用,要是遇到手册说得不清楚或者自己无法理解的情况,还需要我们动手实践,自己去摸索它们大致的功能和作用。
要不然以后遇到没有参考的时候,就只能干瞪眼了。就算有参考,也建议大家自己调一遍,不要复制黏贴,不要怕浪费时间。就好比这篇文章,我相信会有人看完后拿着逻辑分析仪一遍一遍的尝试,但恐怕更多的还是复制代码,能用就行。
自己调通自己写驱动代码,我觉得这才是做BSP的核心和魅力所在。