一、GPIO介绍$ J/ x1 G8 m, I) X2 |2 i8 Q
1.1 GPIO 简述2 s O( r0 r/ E6 `/ m, k
GPIO(General purpose input/output,通用型输入输出),一个引脚可以用于输入、输出或其他特殊功能,PIN脚依现实需要可作为通用输入(GPI)或通用输出(GPO)或通用输入与输出(GPIO),并多个GPIO一起组合可实现诸如UART、SPI等外设功能。: g# m/ A( l3 S' I; n
- Z% m# O8 S8 f+ C! n8 G1 b
GPIO是通过寄存器操作来实现电平信号输入输出的,对于输入,通过读取输入数据寄存器(IDR,Input Data Register)来确定引脚电位的高低;对于输出,通过写入输出数据寄存器(ODR,Output Data Register)来让这个引脚输出高电位或者低电位;对于其他特殊功能,则有另外的寄存器来控制它们。GPIO的输出通常可以输出0/1信号,用来实现如LED灯、继电器、蜂鸣器等控制,而GPIO的输入可识别0/1信号,用来实现开关、按键等等动作或状态判定。, E7 Q( x" j; S- u: Y
$ x" V5 G. g/ p" v! N3 S, ^
) I) D, W2 O9 L2 t7 |! E% ]
: V+ o- [' _' N# c
' D* P G& k4 Z) ^
1.2 STM32 GPIO寄存器. k- @( E/ N1 @* x# _' v
STM32中GPIO的寄存器是MCU分配的一个连续存储区域,按存储地址划分出不同功能寄存器,如下图所示,有Port mode寄存器、Output Type寄存器等等。
6 \% ^ k {2 c5 }2 n7 w
% ]4 w( v* a" c2 n6 G: z6 u# A6 Q& L ^2 t& O
6 }* |1 O! o6 W1 @9 `4 _. G
U9 y4 ?* K" C$ H) @/ f" C3 s, l1 X 在HLA库中,这些寄存器的数值(宏定义)通常会放在/Drivers/CMSIS/Device/ST/STM32L4xx/Include/stm32XXX.h头文件中,供开发者调用,例如STM32L496VGTx的开发板,该头文件具体名是stm32l496xx.h,自8977行起到10008行,具是按上述表宏定义了GPIO各寄存器的各个数据位可设置数据值(偏移(POS)及相应数值)。
0 _- Y9 t& V$ a% i. o0 Z1 x- r: d4 u% h3 ` B7 q) d9 I5 J3 R4 E
+ t) Y+ ~2 j- U$ s3 s! K2 }7 I
7 m2 C3 ]0 |6 ~4 C$ S# r# C; q 1.3 GPIO引脚与标记( w; L' O s& D/ h( s
在一个STM32 MCU芯片中,所有引脚本质都是GPIO引脚,只是鉴于全GPIO引脚开发者使用起来比较不方便,于是才通过各个GPIO组合形成针对各个外设的IO接口。在CubeMX中,以STM32L496VGTx芯片为例,可以直观看到该芯片有100个引脚:LQFP100,LQFP是封装,100指的是引脚数。
2 a6 M& }' F1 g0 ?" T: T8 K
$ i4 _1 W9 s) I5 [
1 S: S8 r0 ]% }( O! U& T, \& o5 t3 B$ Q1 \8 }5 O% f
STM32的MCU标记一般有两种,直插IC以半圆条口为标记,贴片IC以小圆点为标记,也有缺口及小点都有标记的。通常将标记圆点或缺口正面朝左上角,左上角的下方脚为第一脚,依次围绕芯片中心逆时针计数,在旋转360度以后,左上角右方角为最后一脚。如上图所示,STM32L496VGTx引脚序号如蓝色字体及箭头所示标记。STM32的MCU的引脚标记有三种方式:
( C9 r; {7 v, l$ P: T. y/ h: j2 P( M5 H0 {1 l" p7 p; F+ e. h! d
一种是基于上面所述的100个序号排序P1、Pn等,这种标记目前一般是在直接操作寄存器地址或使用标准库中使用,目前HLA库、LL库已经不提供直接地址偏移方式的API了,而是给没一组分组提供了独立寄存器来处理该组引脚;9 x, U5 ?. t3 f4 P* P: x3 C
) b: O/ w0 r8 F/ h! f: b: j 第二种是标准库或HLA库宏定义了引脚分组,一般为A、B、C、...,按大写字母次序网线,目前支持到16组类别,每组为PX0~PX15,其标记就是分组名+0~15序号,例如GPIOB+GPIO_PIN_3。
4 X" ~2 }4 j) B
# r4 a; o, }1 J) [$ p& T, r 注意,目前STM32的MCU设计是最大16组类别,支持到256引脚(16*16),通过STM32命名规范可以得知,STM32最做引脚支持到256个,但一般会少于引脚数/16的组数,因为不少引脚在芯片设计时就特别支持了其引脚标识,如VSS、VDD等。另外也不是每组必须0~15序号全用完,分组主要是方便设计及使用时进行引脚区分而已。
+ j! v, k9 p4 u! d" m1 H$ i7 [2 w! C" {& d" G$ U
% L$ J; J+ D3 u9 l+ P
( U) k) L$ F' f+ O1 e9 m' u' `2 Y 目前HLA库主要就是这种方式,例如来看看GPIO读取数据的API(HAL_GPIO_ReadPin)实现,主要就是根据引脚序号(0~15)来读取IDR寄存器内对应数据位的数值。7 W' ^, s1 E3 k( _1 p# j
, p; ]0 ~; b6 W
" N$ P: P' M3 N+ X$ P1 _. H9 U4 ]# h8 p4 Z
GPIO分组引脚地址在HLA宏定义数值如下。* V# @- r7 Q4 @" I
- #define GPIO_PIN_0 ((uint16_t)0x0001) /* Pin 0 selected */
0 q) o5 y C% f* M w - #define GPIO_PIN_1 ((uint16_t)0x0002) /* Pin 1 selected */' M$ W v7 C. R
- #define GPIO_PIN_2 ((uint16_t)0x0004) /* Pin 2 selected */. f7 h9 E; q0 K; D, p
- #define GPIO_PIN_3 ((uint16_t)0x0008) /* Pin 3 selected */
1 {/ `/ H8 s7 W( r: b; X - #define GPIO_PIN_4 ((uint16_t)0x0010) /* Pin 4 selected *// O. M# o0 u R% u9 {9 m6 K
- #define GPIO_PIN_5 ((uint16_t)0x0020) /* Pin 5 selected */
7 E6 E" [& E( U$ w X - #define GPIO_PIN_6 ((uint16_t)0x0040) /* Pin 6 selected */
$ J# Q; b- [( k5 T9 U, @ - #define GPIO_PIN_7 ((uint16_t)0x0080) /* Pin 7 selected */: u% t- H0 \6 c" W/ R! Z4 n
- #define GPIO_PIN_8 ((uint16_t)0x0100) /* Pin 8 selected */
! Y2 _# k- T: S* ]! C - #define GPIO_PIN_9 ((uint16_t)0x0200) /* Pin 9 selected */
j. ^$ t- T/ G f - #define GPIO_PIN_10 ((uint16_t)0x0400) /* Pin 10 selected */
; G2 b( o) \; w - #define GPIO_PIN_11 ((uint16_t)0x0800) /* Pin 11 selected */, ^" z9 Z, y$ U) e% X, H2 K: `+ B- p0 L
- #define GPIO_PIN_12 ((uint16_t)0x1000) /* Pin 12 selected */, \0 i' x n0 i% B3 A7 K8 }4 R
- #define GPIO_PIN_13 ((uint16_t)0x2000) /* Pin 13 selected */1 s- _5 M. T k
- #define GPIO_PIN_14 ((uint16_t)0x4000) /* Pin 14 selected *// o# Q% |7 V9 a% T$ P3 E1 D- l
- #define GPIO_PIN_15 ((uint16_t)0x8000) /* Pin 15 selected */
/ d% c% _1 J, F$ T* d - #define GPIO_PIN_All ((uint16_t)0xFFFF) /* All pins selected */
复制代码
/ S+ p6 C1 G" @" t$ c& I j 而GPIO各个分组的IDR寄存器为32bit宽度的数据,目前只用到低16位字段。
5 I. F1 G' u+ z- typedef struct/ d3 E- `5 i U! r: h( `! c
- {
) g7 u* C! y( n" U! ]) |8 a8 ` - __IO uint32_t MODER; /*!< GPIO port mode register, Address offset: 0x00 */
! B: f0 u# j# Z. |3 ~, U - __IO uint32_t OTYPER; /*!< GPIO port output type register, Address offset: 0x04 */
% {- A J4 H5 a6 y/ x - __IO uint32_t OSPEEDR; /*!< GPIO port output speed register, Address offset: 0x08 */
7 J5 Z- F6 v, L7 r, ^ - __IO uint32_t PUPDR; /*!< GPIO port pull-up/pull-down register, Address offset: 0x0C */ F! K2 x& j% q0 V7 y& r* |
- __IO uint32_t IDR; /*!< GPIO port input data register, Address offset: 0x10 */
8 Z$ U" o Y) h4 v- I) Z - __IO uint32_t ODR; /*!< GPIO port output data register, Address offset: 0x14 */
- Z. {1 Q4 [. M* @6 N6 A3 U$ i8 ] - __IO uint32_t BSRR; /*!< GPIO port bit set/reset register, Address offset: 0x18 */
, k% k/ d, A+ H - __IO uint32_t LCKR; /*!< GPIO port configuration lock register, Address offset: 0x1C */2 _$ m5 Z0 [; R) h
- __IO uint32_t AFR[2]; /*!< GPIO alternate function registers, Address offset: 0x20-0x24 */
. E- ]) m+ O+ X5 |; d - __IO uint32_t BRR; /*!< GPIO Bit Reset register, Address offset: 0x28 */, U* H4 p" ~0 W1 I
-
" T6 K6 W: Y. Y' v, v i/ X - } GPIO_TypeDef;
复制代码 5 ~0 w4 x2 i, c: m, `# w
第三种引脚标记其实就是在第二种方式基础上,为引脚设置别名,在cubeMX设置引脚mode后,会开启该引脚,在引脚参数设置列表可以设置该引脚标识名,例如下图,设置PE3(P2)为输出模式(GPIO_Output),的别名为LED1。
) t" X7 Y! b2 A# A1 G' G, s, V2 J4 @0 R9 Z$ F k5 N
7 h/ v' R0 \7 j6 Y3 Q5 e5 Y
- L l8 V: D, x, S: x" t
那么在生成输出代码时,会通过#define实现标识名替换。8 r$ u- s; ^, `
7 X) U3 h( I% G/ U' X
$ M+ \0 l: L* Y$ ?1 Z# }- u
7 S& _ n% K0 G4 ^; R! Z( A ?" q5 x0 H! w6 e) t/ S
1.4 GPIO原理框图及CubeMX配置
8 i* r3 V- x R, U# v 进一步,再看看GPIO结构原理图,它支持4种GPIO输入模式(浮空输入、上拉输入、下拉输入、模拟输入)和4种GPIO输出模式(开漏输出、开漏复用输出、推挽输出、推挽复用输出)。因此才能通过多种输入输出模式组合来实现更复杂的其他外设功能。- t4 W3 ?8 F+ }3 Q _- t: L
# i7 F% T8 X$ L; l
8 p* w' b+ O2 K
' R$ s$ ]0 C% U' m 在cubeMX中在GPIO配置界面中,可以配置GPIO引脚的GPIO输入模式以及其他参数设置。+ R( F+ P2 \, C
( k$ e) {0 ^0 P0 N6 o0 N4 ]
6 n9 I. x* p4 J$ M
' T' V+ o( c% Q4 V5 y 同样地,在cubeMX中在GPIO配置界面中,可以配置GPIO引脚的GPIO输出模式以及其他参数设置。, {) n, f. b* f+ c7 H. A. o M
7 x0 F, E1 y2 D
' Z! m9 z0 w- I3 [2 b5 f
( I" w! X8 \+ R 另外各种基于GPIO组合实现的外设,也可在GPIO栏的各个外设页面下,单独设置各个引脚的GPIO输入或输出模式。0 Q; e/ Z' a, i) h" n/ O7 M& u
3 Z3 O. |9 a" e( g
! H. @! P4 E! G5 |- Y. i5 _/ J& \
, v5 _$ K# T! e! v6 |! ~, [# H0 G& P; B 二、GPIO的HLA源码分析
5 O( H8 V/ w( z' A6 Q. A: B* B. ] 2.1 HLA库GPIO初始化% }: k% A) J+ I4 M
通过cubeMX生成输出源码,如果配置GPIO引脚功能,则cubeMX生成代码时,设置了为每个外设生成独立.h/.c文件时,会在Core源码目录下的Inc及Src目录,分别生成gpio.h和gpio.c驱动文件,否则将会GPOI相关输出函数放置main.h和main.c中。
# F, _: q0 z0 z
3 H3 l9 ^1 p7 S3 s( F& k' v% O 在gpio.c文件中,主要定义了MX_GPIO_Init函数,该主要做三件事情,一是启动各个GPIO分组寄存器的时钟,二是对于输出GPIO引脚实现初始值写入,三是将在cubeMX上配置引脚参数写入到参数缓存区域,并依据缓存参数,调用HLA库的HAL_GPIO_Init来实现真正的初始化设定。如下面代码所示。: O' q1 u# d8 p6 H! ^ ~8 P6 Z
2 z9 |' m3 s9 O/ q8 Q# ?% Q
- //main.h
6 J9 `. c. D9 i+ m3 U - /* Private defines -----------------------------------------------------------*/& M) E' D2 m# O1 t
- #define LED1_Pin GPIO_PIN_3/ _3 Z, H+ I9 E* f' N
- #define LED1_GPIO_Port GPIOE
' p( f- ~, R: U7 w; r6 t# z3 Q3 Q) P, i - #define KEY2_Pin GPIO_PIN_10! I2 _! u$ D# ~, Y. N
- #define KEY2_GPIO_Port GPIOE6 T, N) r" ^0 D3 l2 b1 R) s
- #define KEY0_Pin GPIO_PIN_112 Q+ ?5 u" h" {6 ^: b! n' Q( m. z6 j
- #define KEY0_GPIO_Port GPIOE
7 t5 W% g* s# R1 g - #define KEY1_Pin GPIO_PIN_145 A2 F+ [7 b2 Q9 l o" f
- #define KEY1_GPIO_Port GPIOE
7 ?+ M: h1 y4 A' o4 ~ - #define LED2_Pin GPIO_PIN_157 D8 x* Z" C) f/ F8 Y; T! G. k
- #define LED2_GPIO_Port GPIOD, a& P7 y7 |% W1 [
- #define LED0_Pin GPIO_PIN_68 _# x$ E! Z; z' c
- #define LED0_GPIO_Port GPIOB
$ \8 j0 c) g, ?+ ]; g1 F4 q - /* USER CODE BEGIN Private defines */
|6 h/ b n+ s$ l - //gpio.c
" X/ O M& X, O3 g9 k/ w - void MX_GPIO_Init(void)
4 Y+ ~) M0 S5 I7 z8 l2 W2 E - {
5 N/ P0 w0 x* U+ C) k% S' A -
9 p1 ?5 X' e3 d2 k - GPIO_InitTypeDef GPIO_InitStruct = {0};3 |4 d$ \" l3 h2 o3 a) R0 y
- 8 L) p; C0 Q) a
- /* GPIO Ports Clock Enable */
( B0 V5 X8 S. j1 K9 r; Y - __HAL_RCC_GPIOE_CLK_ENABLE();# v2 C% ]. W0 Z4 k, e' T
- __HAL_RCC_GPIOC_CLK_ENABLE();
0 e& F1 ]3 g* C. ~ - __HAL_RCC_GPIOH_CLK_ENABLE();" q7 G8 A+ r4 C& ~4 A
- __HAL_RCC_GPIOB_CLK_ENABLE();
! j1 m. ^1 q9 Z" j - __HAL_RCC_GPIOD_CLK_ENABLE();
L$ P7 a, ]) X# i% u - __HAL_RCC_GPIOA_CLK_ENABLE();
8 I8 M+ f* }6 w8 M - % L, R! h \* G3 E4 N4 K) V6 \/ ?
- /*Configure GPIO pin Output Level */
( P6 v; A; K( ^8 Z - HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, GPIO_PIN_RESET);6 n+ Y* Q8 W) R5 j, g7 r# T
-
4 T- d5 p3 u5 N1 Q - /*Configure GPIO pin Output Level */
) j/ _" b& Q8 L% h: G - HAL_GPIO_WritePin(LED2_GPIO_Port, LED2_Pin, GPIO_PIN_RESET);( W) `! M6 V, G
- ' k; F1 X* s; r; T3 I
- /*Configure GPIO pin Output Level */
/ Q7 }9 U" |" P - HAL_GPIO_WritePin(LED0_GPIO_Port, LED0_Pin, GPIO_PIN_RESET);
5 b+ V7 K0 p: E9 F, I - - Y _* u. _9 s2 b' ~' l, F
- /*Configure GPIO pin : PtPin */; Y v8 B9 U/ I9 |' v( u" b, ?
- GPIO_InitStruct.Pin = LED1_Pin;& T( f9 y3 s* e1 V9 h0 y. F
- GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;. T+ v2 \5 g7 \4 I7 q( a
- GPIO_InitStruct.Pull = GPIO_NOPULL;
) s6 B) ~* G2 n - GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
$ b' A/ q2 u {) M$ F. a+ i - HAL_GPIO_Init(LED1_GPIO_Port, &GPIO_InitStruct);- }7 d8 _$ j% a C* Q4 f
-
/ U* Y" j3 z0 C: j. M - /*Configure GPIO pins : PEPin PEPin PEPin */
l' B1 V8 k! r. w - GPIO_InitStruct.Pin = KEY2_Pin|KEY0_Pin|KEY1_Pin;% x6 q6 C/ a8 m$ G- @$ j
- GPIO_InitStruct.Mode = GPIO_MODE_INPUT;! J, e# C) P! x2 M" ?5 U
- GPIO_InitStruct.Pull = GPIO_NOPULL; X% L4 J) a4 m2 q! q
- HAL_GPIO_Init(GPIOE, &GPIO_InitStruct);7 s+ s4 S% W5 }4 S- a0 q
-
$ E0 d8 G, n: q/ R - /*Configure GPIO pin : PtPin */
6 F4 l! R7 h" s2 g ?. z - GPIO_InitStruct.Pin = LED2_Pin;
$ [ E( V' ]- b0 t9 S - GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
" b; n' X( W4 ~. X& j4 k- u - GPIO_InitStruct.Pull = GPIO_NOPULL;- ^" j- x+ _ ~* H# Z2 R+ _4 I! F
- GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
+ P- _+ c& z# `- b: f - HAL_GPIO_Init(LED2_GPIO_Port, &GPIO_InitStruct);
4 {" w2 h [) o) ~9 U5 w* k! o -
8 ~; C) |/ |8 E) b, ~9 I3 \6 k" t - /*Configure GPIO pin : PtPin */
4 x- U) m/ g& ^0 \ - GPIO_InitStruct.Pin = LED0_Pin;/ L$ |5 S6 ~' G, ~% |6 Z" G. @
- GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;# ^/ x) U$ l) n2 Z8 H
- GPIO_InitStruct.Pull = GPIO_NOPULL;8 Z' @5 |! t& g+ U- }
- GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;# q% g! w/ I8 `5 ]0 i1 u
- HAL_GPIO_Init(LED0_GPIO_Port, &GPIO_InitStruct);
: [# ]7 k7 F2 f f; P: D0 V2 ` - 5 f" u- i. C& v8 l
- }
复制代码 " ~- }- g' `2 S' @* o
在stm32l4xx_hal_gpio.c源文件中定义了HAL_GPIO_Init函数,它做以下事情:1)诊断先前缓存配置参数是否合规,2)再将缓存配置参数写入到GPIO的寄存器内,完成GPIO的初始化设定(GPIO 的Mode、Pull、Analog、Alternate、Direction、EXTI等)。3 l, M) P2 @# @0 e/ B, {0 Q" F2 T+ \
% E, Q4 o3 e- B$ _7 c" }0 ?& B5 F
) O, ~: a% A8 P) o0 U5 `# U! a0 B2 f+ S! }; j
2.2 GPIO的开发应用接口API简述2 @$ B4 l) E/ `0 Y
除了提供GPIO初始化API外,STM32的HLA针对GPIO还外开发这提供如下API:
0 O+ S9 ]2 W% ^2 p: ?" _, m6 M/ p- T, r. l2 p$ X) s. Z
6 D$ h j2 z" x/ Y6 r1 S
" E+ r1 H2 q* U) U" x" u9 p GPIO对数据的读取主要是HAL_GPIO_ReadPin函数,写入主要是HAL_GPIO_WritePin、HAL_GPIO_TogglePin函数,其参数都是GPIO_TypeDef* GPIOx和 uint16_t GPIO_Pin,前者就是前面参数的分组如GPIOA、GPIOB等,后者就是Pin0~Pin15,例如GPIO_PIN_3。
! _. U% @, L" Q& H( Y! }
8 r) l4 A( s/ N1 H; \% S 关于外部中断回调函数HAL_GPIO_EXTI_Callback,该函数是弱函数
& q/ j3 `0 I4 L) } H( d j) G# k( g J+ H, I+ ]" \
- J+ U) B/ Y1 F: J2 W. i" w
) U7 f# U' c6 g 若需要使用该函数,使其生效,首先需要在cubeMX配置界面,将GPIO引脚调整为GPIO_EXTI类型
* Z) N8 j2 [* u: G8 i, x
1 t% M: u5 d& t* D+ G# Z
/ \; @! e) r$ y3 ^6 |3 a. \& q& q
' i3 j* w' @2 ?- F2 C4 u$ S. U! n 并开启该引脚的中断支持# k8 A5 {6 D: S* j
, K5 [* W) U6 U0 L' ~
4 H c8 _0 g) o6 q5 T3 J- o$ M% ~0 t9 F% L o; K+ s! K5 l
就可以重新实现stm32l4xx_hal_gpio.c文件中的HAL_GPIO_EXTI_Callback函数来实现GPIO外部中断回调功能,例如设置如下,则实现按键KEY0按下异常,触发回调函数HAL_GPIO_EXTI_Callback调用,从而实现LED0灯状态反转(点亮或熄灭):$ ~/ p5 ]2 n3 z ^' ?
- /* USER CODE BEGIN 0 */. G$ u3 |- Y7 Z- }! h8 J
- void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
3 c. D0 ] u& ~( S: e1 b - {8 i d9 g' G2 M1 g% j
- if(GPIO_Pin==KEY0_Pin)9 L- E% Y4 j/ ^6 P" A( `
- {
+ I1 Z2 x) \% x" v+ q) N. W - static uint32_t key0_count = 0;% `0 c) ]- d+ U
- printf("this is %lu count for HAL_GPIO_EXTI_Callback!\r\n",key0_count++);! f U2 |& U6 E, f- d
- Toggle_led0();//LED0等状态反转一次: M4 o: x" C! h% X3 C, v
- }
5 _9 F& X( N3 @! D% w* T - }
4 k3 F# T( ~/ Z$ p - /* USER CODE END 0 */
复制代码
, U$ h f! G4 Q. D. D- X 同样地对于外部中断请求函数HAL_GPIO_EXTI_IRQHandler也可以类似地进行调整实现GPIO外部中断触发器调用,从而实现我们需要的业务应用。+ E' t7 T3 A, [) [
) A* V& P* {0 c
GPIO的HLA库中,HAL_GPIO_LockPin函数,主要是操作lock寄存器数值的,lock寄存器会针对GPIOx_MODER, GPIOx_OTYPER, GPIOx_OSPEEDR等GPIO寄存器配置对应的状态标记,而其他寄存器操作时,会先去lock寄存器读取其使用状态来确定是否能进行相关操作,从而确保防止冲突及达成一致性。
1 i/ |5 b$ k* y+ e" x: h7 I————————————————* U6 u* j1 B" {& j
版权声明:py_free-物联智能
7 U8 b# [/ O5 n. M) }如有侵权请联系删除2 C+ I( e3 y7 c2 |4 _
|