HAL_GPIO_WritePin 用法

HAL_GPIO_WritePin 是一个函数，用于向指定的GPIO引脚写入特定的值（高电平或低电平），其用法如下：

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

其中，参数 GPIOx 指定了所要操作的GPIO端口，例如 GPIOA、GPIOB 等；参数 GPIO_Pin 指定了所要操作的GPIO引脚，可以通过宏定义 GPIO_PIN_x 来指定，其中 x 为引脚编号；参数 PinState 指定了要向该引脚写入的电平状态，可以是 GPIO_PIN_RESET 或 GPIO_PIN_SET。

例如，将 PA5 引脚输出高电平的代码如下：

HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);

需要注意的是，使用 HAL_GPIO_WritePin 函数前需要先启用相应的GPIO端口时钟，并将该引脚配置为输出模式。

相关问题

HAL_GPIO函数讲解

### HAL_GPIO函数使用教程与功能详解

#### 初始化GPIO引脚
`HAL_GPIO_Init` 函数负责根据 `GPIO_InitTypeDef` 结构体中指定的参数初始化 GPIO 外设。此结构体包含了关于引脚号、模式、速度以及上下拉电阻配置的信息[^1]。

GPIO_InitTypeDef GPIO_InitStruct = {0};
/* 配置PA0为推挽输出 */
GPIO_InitStruct.Pin = GPIO_PIN_0;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

#### 反初始化GPIO引脚
通过调用 `HAL_GPIO_DeInit` 将特定 GPIO 的寄存器恢复至默认复位状态，这通常是在重新配置前清理旧设置时使用[^2]。

HAL_GPIO_DeInit(GPIOA, GPIO_PIN_0);

#### 读取引脚电平
利用 `HAL_GPIO_ReadPin` 来获取某个具体引脚当前的状态（高/低），这对于检测按钮按下或是传感器信号非常有用[^3]。

uint8_t pinState = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0);
if (pinState != GPIO_PIN_RESET){
    /* 执行当引脚处于高电平时的操作 */
}

#### 设置引脚电平
要控制 LED 或者其他执行元件，则可以采用 `HAL_GPIO_WritePin` 方法向目标引脚发送逻辑‘1’或‘0’[^4]。

HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET); // 设定为高电平
// 或者
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET); // 设定为低电平

#### 切换引脚电平
对于需要周期性反转电平的应用场景比如闪烁LED灯而言，`HAL_GPIO_TogglePin` 提供了一种便捷的方式来进行快速切换操作[^5]。

while(1){
    HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_0);
    HAL_Delay(500); // 延迟一段时间再继续循环
}

#### 锁定引脚防止意外修改
一旦设置了 `HAL_GPIO_LockPin` 后，在下次硬件重启之前都无法对该引脚做出任何改动，从而提高了系统的安全性[^6]。

HAL_GPIO_LockPin(GPIOA, GPIO_PIN_0);

HAL GPIO WritePin(GPIOA, GPIO PIN 2|GPIO PIN 3 |GPIO PIN 4, GPIO PIN SET);

### 使用 `HAL_GPIO_WritePin` 设置多个 GPIO 引脚

为了设置多个 GPIO 引脚到特定状态，在 STM32 HAL 库中可以利用位操作来组合不同的引脚编号。对于想要一次性控制多个引脚的情况，可以通过按位或运算符 (`|`) 将各个引脚定义连接起来。

针对具体需求，即把 GPIOA 上的 PIN 2、PIN 3 和 PIN 4 同时设为高电平，可采用如下方法：

// 定义要操作的引脚
#define PINS_TO_SET (GPIO_PIN_2 | GPIO_PIN_3 | GPIO_PIN_4)

// 调用 HAL_GPIO_WritePin 函数写入指定状态给这些引脚
HAL_GPIO_WritePin(GPIOA, PINS_TO_SET, GPIO_PIN_SET);

上述代码片段展示了如何通过宏定义的方式将三个不同引脚号相加得到一个新的表示多位的变量 `PINS_TO_SET`[^2]。接着使用此参数作为第二个参数传递给 `HAL_GPIO_WritePin()` 函数，并指明希望它们处于 HIGH 状态（由第三个参数决定）。注意这里假设所有涉及的操作都在同一个端口内完成，因此第一个参数固定传入 `GPIOA`。

需要注意的是，虽然这里的例子只涉及到同一端口内的几个连续引脚，但在实际应用中也可以跨过不相邻甚至跨越不同端口来进行类似的批量配置，只需按照相同的方法构建合适的掩码即可[^1]。