使用STM32F103的HAL库来操作IO口（GPIO）相对简单。HAL库为GPIO配置和操作提供了易用的接口。以下是一个简单的指南，涵盖了如何初始化GPIO和控制GPIO引脚。

步骤1：包含所需的头文件

首先，你需要包含HAL库的头文件：

#include "stm32f1xx_hal.h"

步骤2：初始化HAL库

在main函数的开头，初始化HAL库：

HAL_Init();

步骤3：使能GPIO时钟

在使用某个GPIO端口之前，你需要使能该端口的时钟。以GPIOA为例：

__HAL_RCC_GPIOA_CLK_ENABLE();

步骤4：配置GPIO引脚

定义一个GPIO_InitTypeDef结构体，并设置相关参数以配置GPIO引脚。例如，将GPIOA的第5引脚配置为推挽输出：

GPIO_InitTypeDef GPIO_InitStruct = {0};

GPIO_InitStruct.Pin = GPIO_PIN_5;             // 指定引脚5
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;   // 设置为推挽输出模式
GPIO_InitStruct.Pull = GPIO_NOPULL;           // 不使用上拉或下拉电阻
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;  // 设置速度为低速

HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);       // 初始化GPIOA的配置

步骤5：控制GPIO引脚

使用HAL库提供的函数来设置或复位GPIO引脚。例如，将GPIOA的第5引脚拉高（点亮LED）：

HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);

将GPIOA的第5引脚拉低（熄灭LED）：

HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);

完整示例代码

以下是一个完整的示例，展示了如何初始化GPIOA的第5引脚并反复点亮和熄灭LED：

#include "stm32f1xx_hal.h"

// 初始化系统时钟
void SystemClock_Config(void);

int main(void)
{
    // 初始化HAL库
    HAL_Init();

    // 初始化系统时钟
    SystemClock_Config();

    // 使能GPIOA时钟
    __HAL_RCC_GPIOA_CLK_ENABLE();

    // 配置GPIOA的第5引脚
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.Pin = GPIO_PIN_5;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

    // 主循环
    while (1)
    {
        // 拉高GPIOA的第5引脚
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);
        HAL_Delay(500); // 延时500毫秒

        // 拉低GPIOA的第5引脚
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);
        HAL_Delay(500); // 延时500毫秒
    }
}

// 系统时钟配置函数（根据需要配置）
void SystemClock_Config(void)
{
    // 具体的时钟配置代码根据项目需求设置
}

这个示例程序会让连接到GPIOA第5引脚的LED每隔500毫秒闪烁一次。请确保LED和电阻正确连接到对应的引脚。

总结

通过HAL库来操作STM32的GPIO口非常直观且方便。主要步骤包括初始化HAL库、使能GPIO时钟、配置GPIO引脚、以及使用相应的函数来控制引脚的状态。根据上述步骤，可以轻松地配置和控制任意STM32F103的GPIO引脚。