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

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

[复制链接]
cuyebiren 发布时间:2016-12-6 21:42
! H2 [/ {" i2 Q! }: H* f2 D
STM32电机培训online,大佬带你玩电机9 J  S0 p; y, u/ U8 }% @
【开源】做了一个STLINK/V2-UART二合一编程器
1 Y/ P9 ~- G: x% v! G1 t& a$ b) N* B9 R
【实战经验】UART应用异常案例分析/ x  U) r) U* ]" _5 w
* m+ b- K9 H4 w3 F

% Z" p3 r. n0 |HAL库是比较全面的,封装比较彻底的,也是功能比较强大的。
! f$ u! X8 O8 L' K: K3 D使用HAL库,我们直接调用它的API函数,不用关心它的底层操作过程。9 C" A$ c& c# K8 O0 J
使用HAL库,省去了好多繁琐的处理过程,不再需要我们自己写如等待等过程。
( Y5 n: `0 u. _7 B$ hHAL库也包含如Ethernet、USB等高级外设的驱动。
+ k* @; p" w  _0 T对于初接触它的人来说,尤其是用惯了标准库的人,总会有各种不适应和排斥感。
6 D( v# D$ E) D" G) e# w就拿UART来说,我们通过中断方式接受或发送数据。如果仿真调试的话,会发现UART有开关中断的现象,而不是中断一直开着。
$ Q9 s/ N: u  a( \1 s' Z. |' b9 `0 ^# T$ E) [
下面,就讲解UART常用函数以及中断处理过程。8 e7 l% Y* H! j4 u- R" G7 d
5 D8 L4 g  b7 d$ o- \5 U% k
HAL_StatusTypeDef HAL_UART_Transmit(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout);
% v- K% }' h: g4 ]$ \8 n串口发送,发送指定长度的数据。如果超时没发送完成,则不再发送,返回超时标志(HAL_TIMEOUT)。
, G; v2 b  `. i( K$ z! O" oHAL_StatusTypeDef HAL_UART_Receive(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout);# b) V, }- r5 `' ?/ d4 L0 m" C5 Q, B
串口接收,接收指定长度的数据。如果超时没接收完成,则不再接收数据到指定缓冲区,返回超时标志(HAL_TIMEOUT)。5 e9 o# q; U5 _6 h, f# I. @
* K* j, A  i" \+ c) S+ a4 E/ q
) i% O8 q& A" _2 O* v
HAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
( h0 a# c8 ^/ q8 T7 O- J: `串口中断发送,以中断方式发送指定长度的数据。
4 m" m" Z4 G0 K& {" f5 x! S  \6 s大致过程是,把 发送缓冲区指针 指向 要发送的数据,设置 发送长度,发送计数器初值,然后使能串口发送中断,触发串口中断。" S- O3 `; I, P8 ~9 Z4 N
再然后,串口中断函数处理,直到数据发送完成,而后关闭中断,不再发送数据,串口发送完成回调函数。# E' G( ^) |6 d& C3 T1 c
HAL_StatusTypeDef HAL_UART_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);- F% I/ E. L4 M
串口中断接收,以中断方式接收指定长度数据。, C1 v5 H0 X  @8 V) a; S: r) w
大致过程是,把 接收缓冲区指针 指向 要存放接收数据的数组,设置 接收长度,接收计数器初值,然后使能串口接收中断。接收到数据时,会触发串口中断。
  o( A" K+ `3 w3 I. S再然后,串口中断函数处理,直到接收到指定长度数据,而后关闭中断,不再触发接收中断,调用串口接收完成回调函数。
4 c% X* j$ f( E+ r; H$ h: w' V$ V( D- N" L: t$ V" q: U6 [

/ T/ N5 T$ u% JHAL_StatusTypeDef HAL_UART_Transmit_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);' D$ Z9 |8 s5 x* s9 e; D) S+ Y( l
串口DMA发送,以DMA方式发送指定长度的数据。
' |# ~+ o6 J# d5 \* k2 |) s过程是,把 发送缓冲区指针 指向 要发送的数据,设置 发送长度,发送计数器初值,设置 DMA传输完成中断的回调函数,使能DMA控制器中断,使能DMA控制器传输,使能UART的DMA传输请求。
4 a0 M! w& j; q. R- I( v$ M然后,UART便会发送数据,直到发送完成,触发DMA中断。, u% d# B( `- L" {2 A. a
DMA中断处理,如果 DMA模式 是 循环模式,则 直接 调用 DMA传输完成中断的回调函数。
2 X: ?9 a  `2 ~& K, w8 J如果 DMA模式 是 正常模式,则 先 关闭DMA传输完成中断,不再触发DMA中断,再 调用 DMA传输完成中断的回调函数。) Y  i, C+ D* M
DMA传输完成中断的回调函数处理过程,如果 DMA模式 是 循环模式,则 直接 调用 串口发送完成回调函数。
) e7 T0 o; F! r4 @3 H( z0 J1 D如果 DMA模式 是 正常模式,则 先关闭 UART的DMA传输请求, 再 使能串口传输完成中断,直到传输完成,触发中断。5 n7 ~, h. i7 j" a" m$ D8 Z
串口传输完成中断处理,关闭中断,调用串口发送完成回调函数。
# x8 Z+ B4 D8 n8 }1 GHAL_StatusTypeDef HAL_UART_Receive_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
/ y8 n  a4 V# _$ o5 F串口DMA接收,以DMA方式接收指定长度的数据。6 `# ]8 a* V2 T* a
过程是,把 接收缓冲区指针 指向 要存放接收数据的数组,设置 接收长度,接收计数器初值,设置 DMA传输完成中断的回调函数,使能DMA控制器中断,使能DMA控制器传输,使能UART的DMA传输请求。7 u6 Z, o) G7 U9 W3 {* G' H4 X
然后,UART接收到数据,便会通过DMA把数据存到接收缓冲区,直到接收到指定长度数据,触发DMA中断。
' f- t2 v* R* jDMA中断处理,如果 DMA模式 是 循环模式,则 直接 调用 DMA传输完成中断的回调函数。
% j8 w( j1 g$ l如果 DMA模式 是 正常模式,则 先 关闭DMA传输完成中断,不再触发DMA中断,再 调用 DMA传输完成中断的回调函数。9 b  t; e& W+ o$ E& Z/ O  v
DMA传输完成中断的回调函数处理过程,如果 DMA模式 是 循环模式,则 直接 调用 串口接收完成回调函数。
2 }1 u! F5 k$ u" U  |' c如果 DMA模式 是 正常模式,则 先关闭 UART的DMA传输请求, 再 调用 串口接收完成回调函数。
* O" H( D, A) o' k( q
. H1 [  p! \1 h2 z* n5 f$ H* s: J- z! Y
5 {/ d0 P. R0 E  V$ H0 u
由于函数较多和过长的缘故,下面仅以HAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)为例,分析源码:8 b1 c# [- ^, J+ D, M% \
/**
2 a* C8 @: _, T% \4 U  * @brief  Sends an amount of data in non blocking mode.
" Q" Z6 D0 L9 j* w" y  * @param  huart: pointer to a UART_HandleTypeDef structure that contains. z; \4 e, W9 G6 X8 P2 W- S
  *                the configuration information for the specified UART module.5 J5 k" O5 o0 g
  * @param  pData: Pointer to data buffer
  K7 }& k, r) b: r# B  * @param  Size: Amount of data to be sent
" M. T0 f3 }5 q& _* [+ t/ \2 G  * @retval HAL status: g+ V: z. w9 ]7 O
  */                   串口中断发送,以中断方式发送指定长度的数据。
  |" H3 A( N# L- E0 F: _HAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)
! \6 l( E( M& ]; j; [{                ' e* x1 Z1 ^" z6 z  Q" j+ d1 E7 }
  /* Check that a Tx process is not already ongoing */
; n2 T( e% G$ c/ l: j( k  if(huart->gState == HAL_UART_STATE_READY)    如果 串口空闲,则执行以下语句。
# [2 x7 D* _6 s3 z) ?  {
$ O! U: U0 f+ e3 W    if((pData == NULL ) || (Size == 0U))      如果发送数据为空或者发送长度为0,则返回错误。- j2 C, `/ i7 o+ y, n3 L; g. u
    {7 N& w& m2 Y- x, a9 s" Y) C
      return HAL_ERROR;# L5 W$ v5 E1 l2 S
    }1 B, a+ f' O8 n$ `1 ?

" l3 }! a& x2 Z. E8 S8 }9 p, v" l) C    /* Process Locked */* D0 y0 c" Q% _4 q. U
    __HAL_LOCK(huart);                上锁。
2 t$ f+ }) `' G" U! y. H0 z. M  P  [( S$ p+ v" d# n
    huart->pTxBuffPtr = pData;               结构体变量 huart 的 参数设置。发送缓冲区,发送长度,发送计数器。
' `% T/ Z8 ^, Y! n& ]( i& Q- p" K; K* m    huart->TxXferSize = Size;
5 Q+ W3 B- c( g: @' e    huart->TxXferCount = Size;6 d/ |: u8 {0 F4 _$ x* B3 U

) z7 w9 O% C# a) \) N4 T0 U: @    huart->ErrorCode = HAL_UART_ERROR_NONE;
* _+ d+ P) d' w    huart->gState = HAL_UART_STATE_BUSY_TX;           状态设为 发送繁忙。# a) ]) D5 O+ p$ m- b5 X9 G" R1 T
7 z  _" `( e5 e0 O
    /* Process Unlocked */1 _: q% [9 Z+ f' L; x
    __HAL_UNLOCK(huart);               解锁。
3 R& a* l+ A' X2 _1 Q% {' G. U, b
6 k$ g- |6 Q7 E    /* Enable the UART Transmit data register empty Interrupt */' M/ ~: M% a5 D; M# g7 x! m1 V' n, n
    SET_BIT(huart->Instance->CR1, USART_CR1_TXEIE);              使能UART发送数据寄存器空中断,则会触发串口中断(发送中断)。
4 M0 R, \/ p' ]9 \: ]' e7 k- [' [: [% U* [0 h& P$ O& }; g
    return HAL_OK;. U7 t; Y, U, T/ w
  }9 I* m4 ?2 F2 \; M
  else               如果 串口忙,则返回 忙状态。3 D) o  |2 t  g9 a$ x; U
  {$ C! p  V( |* F! C3 X
    return HAL_BUSY;   
5 z+ m4 q% @) F, V8 T  }% n, L2 T" e8 b; l6 K
}" a& Z0 C5 f( a

" g/ o+ e' @. L. q+ i% V5 {0 G+ U; Z# ]- p4 e
赞 1 收藏 25 评论39 发布时间:2016-12-6 21:42

举报

39个回答
any012 回答时间:2016-12-7 09:09:59
感觉HAL库的中断接收不是那么方便。
8 `( A  t7 s% a& [9 b& x有时候其他设备发送过来的数据比较快,用HAL库的中断接受的话,会做很多的判断处理,等到回调函数执行的时候,有可能下个数据就快来了。
sgsong 回答时间:2017-10-16 11:53:56
/**
) Q9 \. L# s  B$ r8 m  * @brief  Sends an amount of data in non blocking mode.0 y* J+ K& |6 V% Z) g
  * @param  huart: pointer to a UART_HandleTypeDef structure that contains
6 ]! L0 E3 ~, n1 W" ?; h0 R" {  *                the configuration information for the specified UART module.
( c% s# M4 h5 [" p! o9 p3 |  * @param  pData: Pointer to data buffer* X* }" U+ K8 D
  * @param  Size: Amount of data to be sent
7 N7 p" v' a/ J/ m! z, ]5 A; G  * @retval HAL status4 i) f( ?* n( M$ }& u
  */                   串口中断发送,以中断方式发送指定长度的数据。
) M. k1 }6 \7 u+ LHAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)' G1 I$ }% ^/ \
{                5 [/ j" H! x6 U0 u. {; J, Z
  /* Check that a Tx process is not already ongoing */
4 G; _4 G( ?4 r3 Q0 M5 u  if(huart->gState == HAL_UART_STATE_READY)    如果 串口空闲,则执行以下语句。
+ A5 B3 X) e3 [& E) V  {
* m! g" ]+ N: K2 H  ?    if((pData == NULL ) || (Size == 0U))      如果发送数据为空或者发送长度为0,则返回错误。
$ V, c: g. G& j; n    {1 t( n0 [0 V( j" J- n1 J  b& a
      return HAL_ERROR;
, g; Q3 S( R& s    }
. m1 x; n: z5 g) |. q: f
8 g% v; G/ p2 x5 z    /* Process Locked */
3 X% J/ t. K( i$ S( q    __HAL_LOCK(huart);                上锁。& A" a; [( _' W4 R0 u* P

) E3 n: i. ?3 Z! ]    huart->pTxBuffPtr = pData;               结构体变量 huart 的 参数设置。发送缓冲区,发送长度,发送计数器。9 O5 d0 d( I1 \
    huart->TxXferSize = Size;+ f% _+ m2 R' U+ [
    huart->TxXferCount = Size;
) D) f# x: Y* L3 m- {. G& ^; s; x% k, y* R. M$ v3 h+ k
    huart->ErrorCode = HAL_UART_ERROR_NONE;
6 E+ q6 L, i$ w- x    huart->gState = HAL_UART_STATE_BUSY_TX;           状态设为 发送繁忙。6 R% P/ |( Q( k& J

& S( _# f9 b- s* {    /* Process Unlocked */
7 u" P1 |0 i* k' V2 D  [7 Y3 E    __HAL_UNLOCK(huart);               解锁。
1 c6 Y" W/ ]3 d% ^: R% M0 C. m
" r0 p) j4 Y/ R5 U/ E0 s' p4 f   /* Enable the UART Transmit data register empty Interrupt */4 L! x$ U! f5 F3 ], J9 p! t0 X  C3 H
    SET_BIT(huart->Instance->CR1, USART_CR1_TXEIE);              使能UART发送数据寄存器空中断,则会触发串口中断(发送中断)。  F9 y; Q3 n3 v0 m

' h! e: b! @& g    return HAL_OK;
2 F0 f2 o+ p8 U4 u" y  w# b  }
/ D# @/ y, {. U6 d  else               如果 串口忙,则返回 忙状态。+ \/ Y% Y+ H6 V( ]8 k: n
  {
' B% r& p$ @. j! e( y1 i    return HAL_BUSY;   
( m. r' o+ Y9 D" _) h% F0 c0 Z# m  }
  ^0 g  g2 C, ~$ r}
. [0 M- `' Q1 I/ G  J  t" `( u
# l9 |  H4 W) q: i, c6 [有个疑问,这个代码发送时,给整个串口上锁了(不是串口发送上锁),如果配置为全双工,这时中断接收数据怎么办?数据来时,串口一直处于忙的状态,数据量大时,数据会不会丢失?这种情况应该就不是全双工了。没找到同时收发数据的官方例程,都是一发一收的。
any012 回答时间:2016-12-7 09:49:14
本帖最后由 any012 于 2016-12-7 09:53 编辑 ' n- v- c0 V0 k) I$ g
cuyebiren 发表于 2016-12-7 09:19
& E% r9 w$ ^6 R. [你可以测试一下,以 115200 波特率 或 更高 长时间测试,看看会不会出现这种情况。。。或者 使用 DMA 方 ...

# K: |' ^6 Z" J+ R3 g2 A& r我的这里要求比较特殊。5 C6 W5 m' `( a# {' ~0 {; J7 c) Z+ Y
stm32的spi作为从设备,中断接收。接收过来的帧信息是固定帧首固定长度,于是我再接收完成回调函数里判断帧首,然后再调用中断模式的接收函数,使设备不断处于接收状态。
* C$ N+ z. x/ n( N  K结果,接收的数据不对,后来逐步排查,发现是接收完一个数据后,调用中断模式接收函数,但再次中断时,直接进入了overrun错误处理。应该是发送过来的数据太快,处理的太慢了。( Z+ S( j8 N. ?6 M5 Q+ N
主设备用的也是stm32,硬件spi,256分频。
% |; S, f7 w" ]; ?( v# {除了接收部分,同时我也要发送数据。开始想在中断接收的回调函数里,调用普通的发送函数,可这个函数的第三个参数是超时判断用的,如果我接收的数据是帧尾,回调函数里我要发送下一个发送帧的帧首,但下一帧信息什么时候来,这个不确定。而一旦超时,就自动关断SPI中断及SPI了。3 }0 X6 J. L' }
. \. _9 \0 j* g5 B
以上问题,我最后在工程里,按标准库的方式写,通过了。: t1 o: E) i: v, ?6 ?; E6 R% i
9 K2 n; J) s3 y7 X3 k6 U7 u
另一个问题是串口中断接收,是作为modbus从设备的,这个不要求接收的同时再发送数据了。但来的每帧信息,里面各数据之间的间隔很短。8 b3 g( M7 }9 c, U1 T, F3 j9 p
我之前从论坛找了个其他网友分享的标准库版modbus文件,挺好用的。改用HAL库没调成功,感觉还是接收到一个数据后,要判断处理的太多。
  M+ `3 q; G  J; J8 X! r0 s" q$ ?) j# y/ h. c+ i
目前HAL库的教程,只找到了硬石科技的STM32F103的教程,正点原子的也有一般STM32F4的HAL教程。" V4 ?9 K2 z+ {& ]$ B7 {
但两个教程里,貌似都没有接收中断这类的例子。' P* K0 ]9 Q' W+ D9 @
原子的教程,sys文件夹下串口部分,貌似也是按类似标准库的方式处理的。
6 ~3 Q$ Z; q9 x( \8 a, r) `* @: a# q& ~
lisingch 回答时间: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. J: p: l" {, c, W" q( o9 |2 s
绝对高手!!!!!!多谢了

, ~0 V% s$ O; u1 v' z我只是研究了下HAL库的源码,做到“知其所以然”而已啦!
斜阳 回答时间:2016-12-7 09:10:19
mARK一下
cuyebiren 回答时间:2016-12-7 09:19:18
any012 发表于 2016-12-7 09:09) U4 Y7 X( F- g
感觉HAL库的中断接收不是那么方便。
6 ^3 t/ C/ Q- L- W  p5 f有时候其他设备发送过来的数据比较快,用HAL库的中断接受的话,会做很 ...
2 C! X& T- I' L  c. V
你可以测试一下,以 115200 波特率 或 更高 长时间测试,看看会不会出现这种情况。。。或者 使用 DMA 方式,应该 不会出现这种情况。。。感觉 HAL 库设计的初衷,是进行 大批量数据 吞吐。。。就是 函数参数 的 size 不是 1,而是相对比较大的值。。。
jackten 回答时间:2016-12-7 10:29:06
谢谢分享                  
zhoupxa 回答时间:2016-12-7 11:56:38
使用HAL库在某些情况下还是有局限性的,如果要求更高的话,还是寄存器编程吧
cuyebiren 回答时间:2016-12-7 13:16:02
any012 发表于 2016-12-7 09:493 h/ n  c; A/ L6 U3 m
我的这里要求比较特殊。
* ^4 ^' x- B. S4 ustm32的spi作为从设备,中断接收。接收过来的帧信息是固定帧首固定长度,于是我再 ...
$ S' }( {' _0 R. v- ^, A, U' D/ i
超时 值 可大可小。超时判断也是可以取消的,好像就是把 超时值 设为 0XFFFFFFFF 。% V% r. s' b3 M1 S) s* E
中断处理函数 中 的 各种判断 是很快的,就是 几个 if 语句而已。除非是 真的 出现 了 传输错误 或 溢出 错误。
( {. a# D3 l: u7 `9 i" c中断回调函数 越短越好,切记 不要在 中断函数中 加延时。
- R6 f8 Y8 Y* C具体 怎么实现各种功能,建议参考官方例程。
cuyebiren 回答时间:2016-12-7 13:25:40
zhoupxa 发表于 2016-12-7 11:56. y! g2 y4 j$ M* Y; U$ q# u
使用HAL库在某些情况下还是有局限性的,如果要求更高的话,还是寄存器编程吧 ...
, ^) g* w4 p& q3 u5 b4 N- @/ Y2 h
HAL库的各种判断,以及中断开关做的是比较好的,处理过程也是比较完整的。标准库仅是封装了操作寄存器的函数。你做低功耗,或者Flash比较小,代码又比较多时,寄存器编程更好。但通常情况下,这种情况的概率很小。。。用库可以把我们从编写大量寄存器中解放出来。。。
zbber 回答时间:2016-12-7 16:41:40
好帖,赞一个,顶楼主6 i# V6 R& m( Z% j- p2 S$ v2 [9 }
*numb 回答时间:2017-3-14 14:48:52
DMA的中断回调函数在哪,找也找不到
123下一页
关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版