你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

HAL库UART的几个常用函数讲解+中断处理过程讲解  

[复制链接]
cuyebiren 发布时间:2016-12-6 21:42

STM32电机培训online,大佬带你玩电机
【开源】做了一个STLINK/V2-UART二合一编程器

【实战经验】UART应用异常案例分析


HAL库是比较全面的,封装比较彻底的,也是功能比较强大的。
使用HAL库,我们直接调用它的API函数,不用关心它的底层操作过程。
使用HAL库,省去了好多繁琐的处理过程,不再需要我们自己写如等待等过程。
HAL库也包含如Ethernet、USB等高级外设的驱动。
对于初接触它的人来说,尤其是用惯了标准库的人,总会有各种不适应和排斥感。
就拿UART来说,我们通过中断方式接受或发送数据。如果仿真调试的话,会发现UART有开关中断的现象,而不是中断一直开着。

下面,就讲解UART常用函数以及中断处理过程。

HAL_StatusTypeDef HAL_UART_Transmit(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout);
串口发送,发送指定长度的数据。如果超时没发送完成,则不再发送,返回超时标志(HAL_TIMEOUT)。
HAL_StatusTypeDef HAL_UART_Receive(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout);
串口接收,接收指定长度的数据。如果超时没接收完成,则不再接收数据到指定缓冲区,返回超时标志(HAL_TIMEOUT)。


HAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
串口中断发送,以中断方式发送指定长度的数据。
大致过程是,把 发送缓冲区指针 指向 要发送的数据,设置 发送长度,发送计数器初值,然后使能串口发送中断,触发串口中断。
再然后,串口中断函数处理,直到数据发送完成,而后关闭中断,不再发送数据串口发送完成回调函数
HAL_StatusTypeDef HAL_UART_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
串口中断接收,以中断方式接收指定长度数据。
大致过程是,把 接收缓冲区指针 指向 要存放接收数据的数组,设置 接收长度,接收计数器初值,然后使能串口接收中断。接收到数据时,会触发串口中断。
再然后,串口中断函数处理,直到接收到指定长度数据,而后关闭中断,不再触发接收中断,调用串口接收完成回调函数。


HAL_StatusTypeDef HAL_UART_Transmit_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
串口DMA发送,以DMA方式发送指定长度的数据。
过程是,发送缓冲区指针 指向 要发送的数据,设置 发送长度,发送计数器初值,设置 DMA传输完成中断的回调函数,使能DMA控制器中断,使能DMA控制器传输,使能UART的DMA传输请求。
然后,UART便会发送数据,直到发送完成,触发DMA中断。
DMA中断处理,如果 DMA模式 是 循环模式,则 直接 调用 DMA传输完成中断的回调函数。
如果 DMA模式 是 正常模式,则 先 关闭DMA传输完成中断,不再触发DMA中断再 调用 DMA传输完成中断的回调函数。
DMA传输完成中断的回调函数处理过程,如果 DMA模式 是 循环模式,则 直接 调用 串口发送完成回调函数。
如果 DMA模式 是 正常模式,则 先关闭 UART的DMA传输请求, 再 使能串口传输完成中断,直到传输完成,触发中断。
串口传输完成中断处理,关闭中断,调用串口发送完成回调函数
HAL_StatusTypeDef HAL_UART_Receive_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
串口DMA接收,以DMA方式接收指定长度的数据。
过程是,接收缓冲区指针 指向 要存放接收数据的数组,设置 接收长度,接收计数器初值,设置 DMA传输完成中断的回调函数,使能DMA控制器中断,使能DMA控制器传输,使能UART的DMA传输请求。
然后,UART接收到数据,便会通过DMA把数据存到接收缓冲区,直到接收到指定长度数据,触发DMA中断。
DMA中断处理,如果 DMA模式 是 循环模式,则 直接 调用 DMA传输完成中断的回调函数。
如果 DMA模式 是 正常模式,则 先 关闭DMA传输完成中断,不再触发DMA中断再 调用 DMA传输完成中断的回调函数。
DMA传输完成中断的回调函数处理过程,如果 DMA模式 是 循环模式,则 直接 调用 串口接收完成回调函数。
如果 DMA模式 是 正常模式,则 先关闭 UART的DMA传输请求,调用 串口接收完成回调函数。



由于函数较多和过长的缘故,下面仅以HAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)为例,分析源码:
/**
  * @brief  Sends an amount of data in non blocking mode.
  * @param  huart: pointer to a UART_HandleTypeDef structure that contains
  *                the configuration information for the specified UART module.
  * @param  pData: Pointer to data buffer
  * @param  Size: Amount of data to be sent
  * @retval HAL status
  */                   串口中断发送,以中断方式发送指定长度的数据。
HAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)
{               
  /* Check that a Tx process is not already ongoing */
  if(huart->gState == HAL_UART_STATE_READY)    如果 串口空闲,则执行以下语句。
  {
    if((pData == NULL ) || (Size == 0U))      如果发送数据为空或者发送长度为0,则返回错误。
    {
      return HAL_ERROR;
    }

    /* Process Locked */
    __HAL_LOCK(huart);                上锁。

    huart->pTxBuffPtr = pData;               结构体变量 huart 的 参数设置。发送缓冲区,发送长度,发送计数器。
    huart->TxXferSize = Size;
    huart->TxXferCount = Size;

    huart->ErrorCode = HAL_UART_ERROR_NONE;
    huart->gState = HAL_UART_STATE_BUSY_TX;           状态设为 发送繁忙。

    /* Process Unlocked */
    __HAL_UNLOCK(huart);               解锁。

   /* Enable the UART Transmit data register empty Interrupt */
    SET_BIT(huart->Instance->CR1, USART_CR1_TXEIE);              使能UART发送数据寄存器空中断,则会触发串口中断(发送中断)。

    return HAL_OK;
  }
  else               如果 串口忙,则返回 忙状态。
  {
    return HAL_BUSY;   
  }
}


1 收藏 24 评论39 发布时间:2016-12-6 21:42

举报

39个回答
any012 回答时间:2016-12-7 09:09:59
感觉HAL库的中断接收不是那么方便。
有时候其他设备发送过来的数据比较快,用HAL库的中断接受的话,会做很多的判断处理,等到回调函数执行的时候,有可能下个数据就快来了。
lising 回答时间:2016-12-7 07:21:08
喜欢,赞!
andypanfan 回答时间:2016-12-7 08:38:39
绝对高手!!!!!!多谢了
高二毛 回答时间:2016-12-7 08:53:06
感谢分享,很详细
cuyebiren 回答时间:2016-12-7 08:56:21
andypanfan 发表于 2016-12-7 08:38
绝对高手!!!!!!多谢了

我只是研究了下HAL库的源码,做到“知其所以然”而已啦!
斜阳__ 回答时间:2016-12-7 09:10:19
mARK一下
cuyebiren 回答时间:2016-12-7 09:19:18
any012 发表于 2016-12-7 09:09
感觉HAL库的中断接收不是那么方便。
有时候其他设备发送过来的数据比较快,用HAL库的中断接受的话,会做很 ...

你可以测试一下,以 115200 波特率 或 更高 长时间测试,看看会不会出现这种情况。。。或者 使用 DMA 方式,应该 不会出现这种情况。。。感觉 HAL 库设计的初衷,是进行 大批量数据 吞吐。。。就是 函数参数 的 size 不是 1,而是相对比较大的值。。。
any012 回答时间:2016-12-7 09:49:14
本帖最后由 any012 于 2016-12-7 09:53 编辑
cuyebiren 发表于 2016-12-7 09:19
你可以测试一下,以 115200 波特率 或 更高 长时间测试,看看会不会出现这种情况。。。或者 使用 DMA 方 ...

我的这里要求比较特殊。
stm32的spi作为从设备,中断接收。接收过来的帧信息是固定帧首固定长度,于是我再接收完成回调函数里判断帧首,然后再调用中断模式的接收函数,使设备不断处于接收状态。
结果,接收的数据不对,后来逐步排查,发现是接收完一个数据后,调用中断模式接收函数,但再次中断时,直接进入了overrun错误处理。应该是发送过来的数据太快,处理的太慢了。
主设备用的也是stm32,硬件spi,256分频。
除了接收部分,同时我也要发送数据。开始想在中断接收的回调函数里,调用普通的发送函数,可这个函数的第三个参数是超时判断用的,如果我接收的数据是帧尾,回调函数里我要发送下一个发送帧的帧首,但下一帧信息什么时候来,这个不确定。而一旦超时,就自动关断SPI中断及SPI了。

以上问题,我最后在工程里,按标准库的方式写,通过了。

另一个问题是串口中断接收,是作为modbus从设备的,这个不要求接收的同时再发送数据了。但来的每帧信息,里面各数据之间的间隔很短。
我之前从论坛找了个其他网友分享的标准库版modbus文件,挺好用的。改用HAL库没调成功,感觉还是接收到一个数据后,要判断处理的太多。

目前HAL库的教程,只找到了硬石科技的STM32F103的教程,正点原子的也有一般STM32F4的HAL教程。
但两个教程里,貌似都没有接收中断这类的例子。
原子的教程,sys文件夹下串口部分,貌似也是按类似标准库的方式处理的。
jackten 回答时间:2016-12-7 10:29:06
谢谢分享                  
1234下一页

所属标签

STM32团队

意法半导体微控制器和微处理器拥有广泛的产品线,包含低成本的8位单片机和基于ARM® Cortex®-M0、M0+、M3、M4、M33、M7及A7内核并具备丰富外设选择的32位微控制器及微处理器


最新内容

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
STM32N6 AI生态系统
STM32MCU,MPU高性能GUI
ST ACEPACK电源模块
意法半导体生物传感器
STM32Cube扩展软件包
关注我们
微信公众号二维码 微信公众号
手机版二维码 手机版