STM32HAL库 -- 3.介绍HAL库中操作GPIO的函数

学习嵌入式的王饱饱

已于 2025-04-15 22:11:56 修改

阅读量1.4k

点赞数 24

CC 4.0 BY-SA版权

分类专栏：告别寄存器！HAL库开发：更快的STM32入门之路文章标签： stm32 单片机 hal库

于 2025-04-15 22:11:35 首次发布

本文链接：https://blog.csdn.net/qq_30634911/article/details/147247845

告别寄存器！HAL库开发：更快的STM32入门之路专栏收录该内容

9 篇文章

订阅专栏

1.简介

直击HAL库中操作GPIO的函数，不介绍寄存器。

2.函数总览

我们打开Keil5软件，查看HAL库中有常用的操作GPIO的函数。操作GPIO的函数基本都在封装在stm32f1xx_hal_gpio.c和stm32f1xx_hal_gpio_ex.c文件中，如下图所示：

下面将分章节介绍常用于操作GPIO的HAL库函数，不会涉及到函数要操作的寄存器，主要介绍函数的功能、参数和返回值，非常友好。

3.GPIO初始化函数 -- HAL_GPIO_Init()

函数原型：

void HAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init);

函数功能：初始化指定的GPIO端口和引脚。

函数参数：GPIOx：GPIO端口，如GPIOA, GPIOB, GPIOC等。

GPIO_Init：指向GPIO_InitTypeDef结构体的指针，该结构体包含了GPIO的配置信息，如引脚号、模式、上拉/下拉、速度等。

仔细地说一下GPIO_InitTypeDef 结构体，结构体的成员如下图所示：

1.Pin：指的是具体的GPIO引脚，可以使用的选值，可以使用‘|’或运算符一次性配置多个引脚，如(GPIO_PIN_1 | GPIO_PIN_2)。引脚定义如下图所示：

2.Mode：指的是GPIO的模式，有4种输入和四种输出模式，定义如下图所示：

上面的宏定义对应的模式如下表所示：

GPIO_MODE_INPUT	输入模式
GPIO_MODE_AF_INPUT	输入复用模式
GPIO_MODE_ANALOG	模拟输入模式
GPIO_MODE_OUTPUT_PP	推挽输出模式
GPIO_MODE_OUTPUT_OD	开漏输出模式
GPIO_MODE_AF_PP	推挽复用模式
GPIO_MODE_AF_OD	开漏复用模式

3.Pull：指定GPIO引脚的上拉或下拉电阻配置。可选的选项如下表和表所示：

GPIO_NOPULL	既不上拉也不下拉
GPIO_PULLUP	上拉模式
GPIO_PULLDOWN	下拉模式

4.Speed：指定GPIO引脚的输出速度，可选值有低速、中速和高速。输出速度的意义如下表介绍：

低速（2 MHz）	用于对性能要求不高的场景，例如连接至低频外设或简单的指示灯控制
中速（25 MHz）	中速适用于大多数常规通信接口，比如USART串口工作在较高波特率下（如115.2 kbps），或者某些慢速SPI应用
高速（50 MHz）	更快速的数据传输需求，高频UART、I²C总线运行于快速模式（400 kHz）及以上的情况

可选的选项如下图和表所示：

GPIO_SPEED_FREQ_LOW	低速模式
GPIO_SPEED_FREQ_MEDIUM	中速模式
GPIO_SPEED_FREQ_HIGH	高速模式

初始化GPIO代码示例，比如配置输出模式：

void GPIO_Output_Init(void)
{
  GPIO_InitTypeDef GPIO_InitStruct = {0};

  /* 使能GPIOA时钟 */
  __HAL_RCC_GPIOA_CLK_ENABLE();

  /* 配置GPIOA引脚0 */
  GPIO_InitStruct.Pin = GPIO_PIN_11;
  GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
  GPIO_InitStruct.Pull = GPIO_PULLUP;
  GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
  HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
}

上面的代码配置了GPIOA的GPIO_PIN_11引脚，推挽输出模式，上拉模式，高速模式。

配置输入模式：

void GPIO_Input_Init(void)
{
  GPIO_InitTypeDef GPIO_InitStruct = {0};

  /* 使能GPIOB时钟 */
  __HAL_RCC_GPIOB_CLK_ENABLE();

  /* 配置GPIOB引脚1 */
  GPIO_InitStruct.Pin = GPIO_PIN_1;
  GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
  GPIO_InitStruct.Pull = GPIO_NOPULL;
  HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
}

上面的代码配置了GPIOB的GPIO_PIN_1引脚，输入模式，不设置上下拉电阻，为浮空输入。注：在输入模式下可以不用配置Speed。

该函数没有返回值。

4.GPIO反初始化函数 -- HAL_GPIO_Deinit()

函数原型：

void HAL_GPIO_DeInit(GPIO_TypeDef  *GPIOx, uint32_t GPIO_Pin);

函数功能：用于将 GPIO 引脚恢复到默认状态的函数。它会清除 GPIO 引脚的模式、速度、上拉、下拉等配置，将其设置为复位后的默认值（通常为模拟模式）。还会禁用 GPIO 引脚的复用功能。

函数参数：

1.GPIOx：用于指定要反初始化的 GPIO 端口。GPIOx 可以是 GPIOA、GPIOB、GPIOC 等。

2.GPIO_Pin：用于指定要反初始化的 GPIO 引脚，可以是单个引脚（如 GPIO_PIN_0、GPIO_PIN_1 等），也可以使用按位或运算符组合多个引脚（如 GPIO_PIN_0 | GPIO_PIN_1）。

该函数没有返回值。

代码示例：

void GPIO_Deinit_Single_Pin(void)
{
    // 反初始化 GPIOA 的引脚 0
    HAL_GPIO_Deinit(GPIOA, GPIO_PIN_0);
}

void GPIO_Deinit_Multiple_Pins(void)
{
    // 反初始化 GPIOA 的引脚 0 和引脚 1
    HAL_GPIO_Deinit(GPIOA, GPIO_PIN_0 | GPIO_PIN_1);
}

void GPIO_Deinit_Whole_Port(void)
{
    // 反初始化整个 GPIOA 端口的所有引脚
    HAL_GPIO_Deinit(GPIOA, GPIO_PIN_ALL);
}

5.GPIO读取数据函数 -- HAL_GPIO_ReadPin()

函数原型：

GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

函数功能：用于读取指定 GPIOx 端口上指定引脚GPIO_Pin_x的当前电平状态。

函数参数：

1.GPIOx：用于指定要读取数据的 GPIO 端口。GPIOx 可以是 GPIOA、GPIOB、GPIOC 等。

2.GPIO_Pin：具体要读取的GPIO引脚。比如GPIO_PIN_1。

函数返回值：GPIO_PinState 是一个枚举型，如下图所示：

返回值说明，如下表所示：

GPIO_PIN_RESET	读取到的引脚电平为低电平
GPIO_PIN_SET	读取到的引脚电平为高电平

代码示例：

void Read_GPIO_Pin(void)
{
    GPIO_PinState pinState;

    // 读取 GPIOA 的引脚 0 的电平状态
    pinState = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0);

    if (pinState == GPIO_PIN_SET)
    {
        // 引脚为高电平，执行相应操作
    }
    else
    {
        // 引脚为低电平，执行相应操作
    }
}

注意事项：

1.在调用 HAL_GPIO_ReadPin() 函数之前，需要确保相应的 GPIO 引脚已经正确配置为输入模式。如果引脚配置为输出模式，读取的结果可能不是外部信号的真实电平状态。

2.该函数一次只能读取一个引脚的状态，如果需要读取多个引脚的状态，需要多次调用该函数。

3.读取的电平状态是当前瞬间的状态，可能会受到外部干扰的影响。如果需要稳定的电平状态判断，可能需要进行消抖处理。

6.GPIO设置电平状态函数 -- HAL_GPIO_WritePin()

函数原型：

void HAL_GPIO_WritePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);

函数功能：将指定 GPIOx 端口的 GPIO_Pin 引脚设置为 PinState 所指定的电平状态。

函数参数：

1.GPIOx：用于指定要设置电平状态的 GPIO 端口。GPIOx 可以是 GPIOA、GPIOB、GPIOC 等。

2.GPIO_Pin：具体要设置电平状态的GPIO引脚。可以是单个引脚，也可以是多个引脚。

3.PinState ：这是一个枚举值。如下图所示：

要写入的引脚电平状态，具体如下表所示：

GPIO_PIN_RESET	将引脚电平设置为低电平
GPIO_PIN_SET	将引脚电平设置为高电平

该函数没有返回值。

代码示例：

void Write_High_To_Single_Pin(void)
{
    // 将GPIOA的引脚5设置为高电平
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);
}

void Write_Low_To_Multiple_Pins(void)
{
    // 将GPIOA的引脚0和引脚1设置为低电平
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0 | GPIO_PIN_1, GPIO_PIN_RESET);
}

void Toggle_Pin_Level(void)
{
    while (1)
    {
        // 将GPIOA的引脚5设置为高电平
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);
        HAL_Delay(500);  // 延时500ms

        // 将GPIOA的引脚5设置为低电平
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);
        HAL_Delay(500);  // 延时500ms
    }
}

注意事项：

1.在调用 HAL_GPIO_WritePin() 函数之前，需要确保相应的GPIO引脚已经正确配置为输出模式。如果引脚配置为输入模式，写入操作将不会产生预期的效果。

2.当引脚处于复用功能模式下，如果复用功能的优先级高于普通GPIO输出功能，写入操作可能无法正常改变引脚电平，需要先正确配置复用功能或禁用复用功能。

3.频繁调用该函数进行电平切换可能会影响系统性能，尤其是在对时间要求严格的应用场景中，需要考虑优化代码逻辑。

7.GPIO翻转电平状态函数 -- HAL_GPIO_TogglePin()

函数原型：

void HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

函数功能：将指定 GPIOx 端口的 GPIO_Pin 引脚的当前电平状态进行翻转。即如果引脚当前为高电平，调用该函数后会将其变为低电平；如果引脚当前为低电平，调用该函数后会将其变为高电平。

函数参数：

1.GPIOx：用于指定要设置电平状态的 GPIO 端口。GPIOx 可以是 GPIOA、GPIOB、GPIOC 等。

2.GPIO_Pin：具体要设置电平状态的GPIO引脚。可以是单个引脚，也可以是多个引脚。

该函数没有返回值。

代码示例：

void Toggle_Single_Pin_Periodically(void)
{
    while (1)
    {
        // 翻转 GPIOA 的引脚 5 的电平
        HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
        HAL_Delay(500);  // 延时 500ms
    }
}

void Toggle_Multiple_Pins(void)
{
    while (1)
    {
        // 同时翻转 GPIOA 的引脚 0 和引脚 1 的电平
        HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_0 | GPIO_PIN_1);
        HAL_Delay(500);  // 延时 500ms
    }
}

注意事项：

1.在调用 HAL_GPIO_TogglePin() 函数之前，需要确保相应的 GPIO 引脚已经正确配置为输出模式。如果引脚配置为输入模式，调用该函数不会产生任何效果。

2.当引脚处于复用功能模式下时，如果复用功能的优先级高于普通 GPIO 输出功能，调用该函数可能无法正常翻转引脚电平。此时需要先正确配置复用功能或禁用复用功能。

3.频繁调用该函数进行电平切换可能会影响系统性能，尤其是在对时间要求严格的应用场景中，需要考虑优化代码逻辑。

8.GPIO锁定引脚配置函数 -- HAL_GPIO_LockPin()

函数原型：

HAL_StatusTypeDef HAL_GPIO_LockPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

函数功能：将指定 GPIOx 端口的 GPIO_Pin 引脚的当前配置（包括模式、速度、上拉/下拉等）进行锁定。一旦引脚配置被锁定，在芯片复位之前，这些配置将无法被修改，从而确保引脚配置的稳定性和可靠性，防止因程序中的意外操作或外部干扰导致引脚配置被改变。

函数参数：

1.GPIOx：用于指定要设置电平状态的 GPIO 端口。GPIOx 可以是 GPIOA、GPIOB、GPIOC 等。

2.GPIO_Pin：具体要设置电平状态的GPIO引脚。可以是单个引脚，也可以是多个引脚。

函数返回值：HAL_StatusTypeDef 是一个枚举型，如下图所示：

返回值说明，如下表所示：

HAL_OK	表示引脚配置锁定成功
HAL_ERROR	表示引脚配置锁定失败

代码示例：

void Lock_GPIO_Pin(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    // 使能 GPIOB 时钟
    __HAL_RCC_GPIOB_CLK_ENABLE();

    // 配置 GPIOB 引脚 5 为推挽输出模式
    GPIO_InitStruct.Pin = GPIO_PIN_5;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_MEDIUM;
    HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

    // 锁定 GPIOA 引脚 5 的配置
    HAL_StatusTypeDef status = HAL_GPIO_LockPin(GPIOB, GPIO_PIN_5);

    if (status == HAL_OK)
    {
        // 引脚配置锁定成功，可进行后续操作
    }
    else
    {
        // 引脚配置锁定失败，可进行错误处理
    }
}

注意事项：

1.锁定不可逆：一旦引脚配置被锁定，在芯片复位之前，无法通过软件方式解锁或修改该引脚的配置。因此，在调用 HAL_GPIO_LockPin() 函数之前，需要确保引脚的配置已经正确设置。

2.兼容性：不同型号的 STM32 芯片对引脚锁定功能的支持可能存在差异，在使用该函数之前，需要查阅相应芯片的数据手册，确认其支持该功能。

3.错误处理：在调用 HAL_GPIO_LockPin() 函数后，需要检查返回值，根据返回结果进行相应的处理，以确保引脚配置锁定操作的成功执行。

对剩余的HAL_GPIO_EXTI_Callback()、HAL_GPIO_EXTI_IRQHandler()以及stm32f1xx_hal_gpio_ex.c中的HAL_GPIOEx_ConfigEventout()、HAL_GPIOEx_DisableEventout和HAL_GPIOEx_EnableEventout()以后使用到再补充说明。