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

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扩展软件包
关注我们
st-img 微信公众号
st-img 手机版