HAL库配置GPIO

### 使用STM32 HAL库配置初始化GPIO

#### GPIO简介
通用输入输出端口（General-purpose input/output, GPIO）允许微控制器与外部世界交互。通过设置不同的模式和状态，可以控制LED、读取按钮状态等操作。

#### 配置流程概述
为了使用HAL库来配置GPIO，在项目中需完成如下工作：

- 创建基于CubeMX或手动创建的MDK工程；
- 将必要的头文件包含到源码中；
- 初始化系统时钟；
- 定义并初始化特定的GPIO引脚；

具体实现细节可参见相关描述[^1]。

#### 示例代码展示
下面是一个简单的例子，展示了如何利用HAL库初始化一个用于输出功能的GPIO引脚，并使其连接的一个LED闪烁。

#include "stm32f1xx_hal.h"

// 定义使用的GPIO端口号以及针脚编号
#define LED_PIN        GPIO_PIN_5
#define LED_GPIO_PORT  GPIOD

int main(void)
{
    // 系统级初始化
    HAL_Init();
    
    // 设置最高优先级中断分组
    __set_PRIMASK(1);

    // 启用GPIOD外设时钟
    __HAL_RCC_GPIOD_CLK_ENABLE();

    // 配置GPIOD Pin5作为推挽输出模式
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.Pin       = LED_PIN;
    GPIO_InitStruct.Mode      = GPIO_MODE_OUTPUT_PP;  
    GPIO_InitStruct.Pull      = GPIO_NOPULL;
    GPIO_InitStruct.Speed     = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(LED_GPIO_PORT, &GPIO_InitStruct);
   
    while (1) {
        // 控制LED亮灭循环
        HAL_GPIO_TogglePin(LED_GPIO_PORT, LED_PIN); 
        HAL_Delay(500);                               /* Delay 500ms */
    }
}

此段程序首先完成了基本的硬件抽象层初始化`HAL_Init()`，接着启用了所需的外围设备时钟`__HAL_RCC_GPIOD_CLK_ENABLE()`, 并定义了一个结构体变量用来存储要应用给指定GPIO引脚的各种参数。最后进入无限循环内不断切换该引脚电平从而让相连的LED灯快速交替点亮熄灭[^3]。