17. STM32H7之GPIO的HAL库API
! O6 H: H& H1 D: \. s我这里简单的总结一下GPIO的APi函数:
HAL_GPIO_Init:此函数用于初始化GPIO
& \4 Y; }  Q: z$ `8 a先定义,配置结构体GPIO_InitTypeDef,再调用此函数初始化
HAL_GPIO_DeInit:此函数用于复位IO到初始化状态
HAL_GPIO_ReadPin:此函数用于读取引脚状态，通过GPIO的IDR寄存器读取。
HAL_GPIO_WritePin:此函数用于设置引脚输出高电平或者低电平。使用GPIO的BSRR寄存器进行设置，使用这个寄存器的好处是支持原子操作，由硬件支持的。
6 X( r( S8 U$ G  M+ pHAL_GPIO_TogglePin:此函数用于设置引脚的电平翻转，使用GPIO的ODR寄存器进行设置。
8 E4 c# c& b9 @2 h6 E$ d& kHAL_GPIO_LockPin:此函数用于锁住GPIO引脚所涉及到的寄存器，这些寄存器包括GPIOx_MODER，GPIOx_OTYPER，GPIOx_OSPEEDR，GPIOx_PUPDR，GPIOx_AFRL 和 GPIOx_AFRH。
注意事项：
  p) B( r; e9 @此函数是锁住用户设置的引脚所对应的寄存器某些位，并不是把整个寄存器都锁住了。
# j5 {5 y* ?/ \6 {7 D6 i9 O一旦锁住后，就不能再修改，只有复位后才可以重新配置。

如何使用HAL库的GPIO驱动
* P; L& @/ g- X使用方法由HAL库提供（本章17.3.1小节提供的例子就是这种方式）：

) r) R8 y' ~, e+ F+ A2 Q& v- b( g第1步：使能GPIO所在总线的AHB时钟，__HAL_RCC_GPIOx_CLK_ENABLE()。
6 }! Y. v. j; j5 Z% d
8 @+ S# k( j2 {% @第2步：通过函数HAL_GPIO_Init()配置GPIO。

(1) 通过结构体GPIO_InitTypeDef的成员Mode配置输入、输出、模拟等模式。

(2) 通过结构体GPIO_InitTypeDef的成员Pull配置上拉、下拉电阻。
- _: Y6 A" J  W# O4 z2 i
* g1 u. O! @3 K6 N7 Y, ](3) 通过结构体GPIO_InitTypeDef的成员Speed配置GPIO速度等级。
% ^2 y4 _& B! b6 k& k
(4) 如果选择了复用模式，那么就需要配置结构体GPIO_InitTypeDef的成员Alternate。
/ [+ X  k$ B" \1 u! Y1 j( W1 _# ?3 [
/ a. @$ c) d, L) u( ?(5) 如果引脚功能用于ADC、DAC的话，需要配置引脚为模拟模式。

(6) 如果是用于外部中断/事件，结构体GPIO_InitTypeDef的成员Mode可以配置相应模式，相应的上升沿、下降沿或者双沿触发也可以选择。
7 P; l) _0 C& w  J! D
& g! K& ~6 J, X+ b: J* d* }% {第3步：如果配置了外部中断/事件，可以通过函数HAL_NVIC_SetPriority设置优先级，然后调用函数HAL_NVIC_EnableIRQ使能此中断。
- T7 O% _2 D; y" |
% s. I% K& D* T+ V第4步：输入模式读取引脚状态可以使用函数HAL_GPIO_ReadPin。
  D1 v2 M) e! v- W) i$ \, G- K
5 X0 F& m( Z2 R" c% c, r) t; v第5步：输出模式设置引脚状态可以调用函数HAL_GPIO_WritePin()和HAL_GPIO_TogglePin。
: w# f' P+ P0 W! _2 Z
1 M8 W8 E" b/ H/ y4 |8 G另外注意下面三个问题：

系统上电复位后，GPIO默认是模拟模式，除了JTAG相关引脚。
% Q# M; n0 t; e5 ~/ M1 L* }关闭LSE的话，用到的两个引脚OSC32_IN和OSC32_OUT（分别是PC14，PC15）可以用在通用IO，如果开启了，就不能再做GPIO。
) W. w& B2 N6 ?4 b7 y) y关闭HSE的话，用到的两个引脚OSC_IN和OSC_OUT（分别是PH0，PH1）可以用在通用IO，如果开启了，就不能再做GPIO。
  R. l* w  j4 s7 T4 g
) i5 b* c5 a! Y' v- v" V5 E
附上简单的 跑马灯程序做例子
; O9 q- `6 W* f' r) m

# V0 N, O- U/ h" I& c; M