|
STM32CubeMX-HAL库的SPI接口使用 6 l8 S7 M9 b: _# Q& |) x
1 _ ~0 {3 k9 p+ ^本文主要介绍STM32的SPI接口、cubeMX软件配置SPI接口和分析SPI相关代码。
c8 P" t, O( O" T4 @STM32之SPI简介:" c T4 \6 J- U2 V
SPI协议【Serial Peripheral Interface】
4 S& J6 g) f# w' U5 L/ }' r, E 串行外围设备接口,是一种高速全双工的通信总线。主要用在MCU与FLASH\ADC\LCD等模块之间的通信。# V+ l. ^( v0 @% i1 t8 w
SPI信号线7 `& Y# @1 b/ r$ l+ q0 f
SPI 共包含 4 条总线。; O0 f3 O3 F) I5 N, A0 @, ~0 i
SS(Slave Select):片选信号线,当有多个SPI 设备与 MCU 相连时,每个设备的这个片选信号线是与 MCU 单独的引脚相连的,而其他的 SCK、MOSI、MISO 线则为多个设备并联到相同的 SPI 总线上,低电平有效。
4 R% {* x4 r( nSCK (Serial Clock):时钟信号线,由主通信设备产生,不同的设备支持的时钟频率不一样,如 STM32 的 SPI 时钟频率最大为 f PCLK /2。
, q4 k; H: O. b. lMOSI (Master Output Slave Input):主设备输出 / 从设备输入引脚。主机的数据从这条信号线输出,从机由这条信号线读入数据,即这条线上数据的方向为主机到从机。
1 O: j, H& S a/ u4 x/ ~1 Y; | u, TMISO(Master Input Slave Output):主设备输入 / 从设备输出引脚。主机从这条信号线读入数据,从机的数据则由这条信号线输出,即在这条线上数据的方向为从机到主机。
) ], C; D$ I$ A) }$ K. @ 其中SCK,MOSI,MISO是接在一起的,NSS分别接到不同的IO管脚控制。主器件要和从器件通信就先拉低对应从器件的NSS管脚使能。默认状态IO1,IO2,IO3全为高电平,当主器件和从器件1通信时,拉低IO1管脚使能从器件1。而从器件2,3不使能,不作响应。下图是主器件与多个从器件通信图。
C& c) M* A! j+ P: K. }/ s
7 \ G- b7 J& o; T6 n SPI特性
8 E; U ]1 W+ X% N, s 单次传输可选择为 8 或 16 位。波特率预分频系数(最大为 fPCLK/2) 。时钟极性(CPOL)和相位(CPHA)可编程设置。数据顺序的传输顺序可进行编程选择,MSB 在前或 LSB 在前。( c D$ v$ H( m# O* U( H! U+ q5 S
注:MSB(Most Significant Bit)是“最高有效位”,LSB(Least Significant Bit)是“最低有效位”。
) M& ~8 y- m! e, Z: b3 S R 可触发中断的专用发送和接收标志。可以使用 DMA 进行数据传输操作。下图是STM32的SPI框架图。# @ g: N! D; Z
" @. E- E- ]0 w6 _$ ~! P; C* |
如上图,MISO数据线接收到的信号经移位寄存器处理后把数据转移到接收缓冲区,然后这个数据就可以由我们的软件从接收缓冲区读出了。当要发送数据时,我们把数据写入发送缓冲区,硬件将会把它用移位寄存器处理后输出到 MOSI数据线。SCK 的时钟信号则由波特率发生器产生,我们可以通过波特率控制位(BR)来控制它输出的波特率。% |4 G& F/ _& G# ]' M0 ]
控制寄存器 CR1掌管着主控制电路,STM32的 SPI模块的协议设置(时钟极性、相位等)就是由它来制定的。而控制寄存器 CR2则用于设置各种中断使能。7 _3 E4 x" @6 p4 w9 G
最后为 NSS引脚,这个引脚扮演着 SPI协议中的SS片选信号线的角色,如果我们把 NSS引脚配置为硬件自动控制,SPI模块能够自动判别它能否成为 SPI的主机,或自动进入 SPI从机模式。但实际上我们用得更多的是由软件控制某些 GPIO引脚单独作为SS信号,这个 GPIO引脚可以随便选择。+ K, u& q2 s- h3 x$ A1 I) Y5 W
SPI时钟时序+ s" f( E0 i0 l: w) p2 z% t
根据时钟极性(CPOL)及相位(CPHA)不同,SPI有四种工作模式。
, N9 Y/ ?/ @, n8 M6 u6 B: P 时钟极性(CPOL)定义了时钟空闲状态电平:
; [! {5 o/ ?! h& E4 zCPOL=0为时钟空闲时为低电平
5 P+ m8 e, d! W2 {CPOL=1为时钟空闲时为高电平& y: d6 F5 e$ l5 j1 @& M" q* S5 U! y
时钟相位(CPHA)定义数据的采集时间。6 V- F, g+ z' p3 \* Y2 ~/ B
CPHA=0:在时钟的第一个跳变沿(上升沿或下降沿)进行数据采样。7 K: z6 p2 I% m5 N+ L r" R. s2 Z
CPHA=1:在时钟的第二个跳变沿(上升沿或下降沿)进行数据采样。
# E& r4 X K; \- v$ [& J
z( C. A+ N9 g/ \ CubeMX软件配置SPI:( r+ M9 f; j# s; ^# f
下面继续介绍cubeMX软件配置STM32L152的SPI接口方法。
2 W: i. w/ F7 _- ^7 L. B: ]0 u- ~(1)打开软件,选择对应芯片后,配置好时钟源;4 H. a4 L! e, d- ?% ]& b' d6 [, e
(2)勾选SPI1为全双工,硬件NSS关闭,如下图:
5 v7 g7 @7 k2 J0 g4 d8 ^
2 g( R0 U) W3 k6 \% @6 t$ I3 ? Y
(3)勾选好后,PA5、PA6、PA7如下图,在配置PA4为普通io口,gpio_output7 U4 N# s: M* s% L
! J, S" u; o! \7 U& R
(4)SPI1的参数配置选择默认,如下图所示
2 l5 {$ [! b, ?- n0 w: R
: ~% V) q0 F7 }2 T(5)生成代码,保存即可。
; A# N+ E( V9 u1 H: ]. r HAL库的SPI函数分析:! S& p3 A6 \, M. {' f
下面具体分析下生成的SPI函数和函数调用。6 B- A; E. s) H; [; ]- i+ j) R
SPI_HandleTypeDef hspi1; //SPI结构体类定义,下面看其结构体内部的声明。
: g1 K* x: A: Z( B
* n8 \/ x4 i" c t9 s/ c+ g! t1 R: _4 r# `
3 j, \# Z% B& U下面分析SPI的初始化函数:
2 H. g& b5 \5 N$ P7 e% d
/ N0 f- ]7 ~1 m- ! ?/ Y9 \4 r2 T0 h" ]" l
- void HAL_SPI_MspInit(SPI_HandleTypeDef* hspi)% g* w: p8 R% H+ d& Y
- {$ p$ W+ o- H0 o5 I' c j8 c& ]
- GPIO_InitTypeDef GPIO_InitStruct;- X9 ~+ T4 C; B, ^
- if(hspi->Instance==SPI1)+ Q2 m& \+ O$ m7 a. \$ |4 G/ X
- {7 u: c7 m* _. L: v
- /* USER CODE BEGIN SPI1_MspInit 0 */( `( x9 M1 @' W/ v9 Q* |7 m7 i/ }
- /* USER CODE END SPI1_MspInit 0 */) n% X: m. a. C1 ?6 R: [( L
- /* Peripheral clock enable */
5 g2 p! R7 c* I" d Q% @$ T4 V - __HAL_RCC_SPI1_CLK_ENABLE();//使能SPI1时钟
# H0 m! z: w" Y& C6 e3 n - /**SPI1 GPIO Configuration
$ A2 h8 p( E9 I, @ - PA5 ------> SPI1_SCK
$ i i& C0 \, n9 P+ g, }9 a$ E - PA6 ------> SPI1_MISO/ \$ O$ g' f* v7 e
- PA7 ------> SPI1_MOSI
! B% X, L f+ u/ g9 { - */8 k' @. A7 G3 K2 O0 L5 z+ \; V3 u
- GPIO_InitStruct.Pin = GPIO_PIN_5|GPIO_PIN_6|GPIO_PIN_7;
7 }1 X6 j4 M6 z2 w3 S- N; ` - GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
- l! j W' t( F) ? - GPIO_InitStruct.Pull = GPIO_NOPULL;
H7 q) Z7 w! E' ` - GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
" J" o" d- Q, G! n0 j/ j* ` - GPIO_InitStruct.Alternate = GPIO_AF5_SPI1;8 c/ W6 g; U5 w9 g2 y
- HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);//配置SPI的数据线和时钟线
}5 x3 s \: Z: M2 v7 w - /* USER CODE BEGIN SPI1_MspInit 1 */0 J4 m, `2 K7 P, [5 ]
- /* USER CODE END SPI1_MspInit 1 */* l$ W( i8 F p. q2 L, Q. V
- }
, k2 v9 N4 ?& `3 h3 b# D - ; ^7 ]4 _& z, N2 I
- static void MX_SPI1_Init(void)
1 O. ^0 S0 @! ?8 [. n/ { - {
! C( [, @2 K* a% {. c - hspi1.Instance = SPI1;" l$ y4 s+ c% D( x$ e6 q
- hspi1.Init.Mode = SPI_MODE_MASTER;//主模式
4 ^# } }! O4 ]7 D( C - hspi1.Init.Direction = SPI_DIRECTION_2LINES;//全双工
/ k$ f( N- z+ S - hspi1.Init.DataSize = SPI_DATASIZE_8BIT;//数据位为8位
7 ~, l$ c; i! ^7 Z$ m1 Q; w - hspi1.Init.CLKPolarity = SPI_POLARITY_LOW;//CPOL=0,low
9 ?* n) `! y) D - hspi1.Init.CLKPhase = SPI_PHASE_1EDGE;//CPHA为数据线的第一个变化沿
& ?- j! x. w6 p; S' d - hspi1.Init.NSS = SPI_NSS_SOFT;//软件控制NSS
+ {3 V+ ~9 U( [' I& w- w$ r - hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_2;//2分频,32M/2=16MHz
! _( q& G* E" E! i - hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB;//最高位先发送: I$ g+ S4 G7 I0 L, D2 F, q- f7 X% I( W
- hspi1.Init.TIMode = SPI_TIMODE_DISABLE;//TIMODE模式关闭
/ _( {2 {& `* T! p% | - hspi1.Init.CRCCalculation = SPI_CRCCALCULATION_DISABLE;//CRC关闭3 x- S# n& u1 }1 Y- ^1 \/ @
- hspi1.Init.CRCPolynomial = 10;//默认值,无效
, w: }6 _( R0 A, S$ d - if (HAL_SPI_Init(&hspi1) != HAL_OK)//初始化
- l5 R; @1 d8 M+ y1 c - {( H& N) L5 |; U! ]! \) s' W: U
- _Error_Handler(__FILE__, __LINE__);! m8 ~- ^- B4 _% a. Y) J
- }% }3 I7 K: F7 z# d. n' W
- }
复制代码 * u9 P1 b' G( e( ~# ~. J+ b
) X0 _! l" D( q4 l. o8 d
利用SPI接口发送和接收数据主要调用以下两个函数:
* V/ v C* Y- t; w8 Z' i9 r2 u( Z$ j& k4 D
( s7 n- b0 J4 N$ h( F( H2 {/ T- HAL_StatusTypeDef HAL_SPI_Transmit(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout);//发送数据- H& |& R% ~/ { A9 _
- HAL_StatusTypeDef HAL_SPI_Receive(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout);//接收数据
复制代码 @; h3 I: I) y( L4 i Z
# u6 { K/ k/ |! v" m0 q* F& z- @4 z3 d) q: A( M& N
. X2 o# @: F' x$ R
, l0 _* f3 F( l7 [: t1 L
! d8 f1 ?9 W+ F" M6 n2 b; p5 Q/ C0 R. g
|