17. STM32H7之GPIO的HAL库API
! j# ~# n+ }& t! O# S$ U我这里简单的总结一下GPIO的APi函数:
. o! @* T6 l! }* [! l6 rHAL_GPIO_Init:此函数用于初始化GPIO
先定义,配置结构体GPIO_InitTypeDef,再调用此函数初始化
HAL_GPIO_DeInit:此函数用于复位IO到初始化状态
; |* q, C' m0 Z3 KHAL_GPIO_ReadPin:此函数用于读取引脚状态，通过GPIO的IDR寄存器读取。
HAL_GPIO_WritePin:此函数用于设置引脚输出高电平或者低电平。使用GPIO的BSRR寄存器进行设置，使用这个寄存器的好处是支持原子操作，由硬件支持的。
" d; W) c( Z  M8 W9 |HAL_GPIO_TogglePin:此函数用于设置引脚的电平翻转，使用GPIO的ODR寄存器进行设置。
# t" I# T) `2 C% N8 KHAL_GPIO_LockPin:此函数用于锁住GPIO引脚所涉及到的寄存器，这些寄存器包括GPIOx_MODER，GPIOx_OTYPER，GPIOx_OSPEEDR，GPIOx_PUPDR，GPIOx_AFRL 和 GPIOx_AFRH。
注意事项：
* j; O, b  K9 q, z6 D- U) C4 m! b% q, b此函数是锁住用户设置的引脚所对应的寄存器某些位，并不是把整个寄存器都锁住了。
. E* D, x0 e" J% {+ S+ E# ^% T4 n2 S一旦锁住后，就不能再修改，只有复位后才可以重新配置。

, `2 t2 G( W. p7 \; k# j" S* h) e如何使用HAL库的GPIO驱动
使用方法由HAL库提供（本章17.3.1小节提供的例子就是这种方式）：

, j, h* r; z. L  Q* S第1步：使能GPIO所在总线的AHB时钟，__HAL_RCC_GPIOx_CLK_ENABLE()。
% O6 J/ l/ ?, N" {: b0 E6 L5 k
; L+ x  C/ ]8 T/ I0 T4 z第2步：通过函数HAL_GPIO_Init()配置GPIO。
' v0 e! V- s& {3 h6 ~
(1) 通过结构体GPIO_InitTypeDef的成员Mode配置输入、输出、模拟等模式。
, z1 p; \3 |  |
0 w4 J/ h$ H' n(2) 通过结构体GPIO_InitTypeDef的成员Pull配置上拉、下拉电阻。

(3) 通过结构体GPIO_InitTypeDef的成员Speed配置GPIO速度等级。

; t2 \% F$ {2 R; N(4) 如果选择了复用模式，那么就需要配置结构体GPIO_InitTypeDef的成员Alternate。

(5) 如果引脚功能用于ADC、DAC的话，需要配置引脚为模拟模式。

0 ~! Y* ?: r. `- z4 l6 T(6) 如果是用于外部中断/事件，结构体GPIO_InitTypeDef的成员Mode可以配置相应模式，相应的上升沿、下降沿或者双沿触发也可以选择。
; c) @$ }- a! @- [8 w
- R/ A) ?9 f4 H. g$ T第3步：如果配置了外部中断/事件，可以通过函数HAL_NVIC_SetPriority设置优先级，然后调用函数HAL_NVIC_EnableIRQ使能此中断。
3 L$ L: ]- |+ J! Q9 a1 C7 {
第4步：输入模式读取引脚状态可以使用函数HAL_GPIO_ReadPin。
+ R6 W  F$ M" B. U, W
第5步：输出模式设置引脚状态可以调用函数HAL_GPIO_WritePin()和HAL_GPIO_TogglePin。

另外注意下面三个问题：
# b; D. ~  v, h: S" I- p
2 \8 @8 F% m" u; L- x系统上电复位后，GPIO默认是模拟模式，除了JTAG相关引脚。
! a) j6 b; H6 D5 t3 B1 ^- ?7 c关闭LSE的话，用到的两个引脚OSC32_IN和OSC32_OUT（分别是PC14，PC15）可以用在通用IO，如果开启了，就不能再做GPIO。
关闭HSE的话，用到的两个引脚OSC_IN和OSC_OUT（分别是PH0，PH1）可以用在通用IO，如果开启了，就不能再做GPIO。

9 Q4 D6 `: G8 M/ N" F
8 e! @2 C( x4 x9 J- i. d$ u' K; b! N附上简单的 跑马灯程序做例子

' S! W; i+ N- z7 x: E4 k

9 j/ k4 n7 Z+ ]9 R2 k8 K) {, c; I