stm32gpio函数

### STM32 GPIO 函数使用教程

#### 初始化GPIO端口
为了使STM32微控制器上的通用输入/输出（GPIO）引脚能够正常工作，在实际编程之前需要对其进行初始化设置。这通常涉及到指定模式（输入、输出、复用功能等）、速度等级、上下拉电阻状态等内容[^1]。

// 定义结构体用于保存配置参数
GPIO_InitTypeDef GPIO_InitStruct = {0};

// 设置要操作的GPIO端口号及引脚编号
GPIO_InitStruct.Pin = GPIO_PIN_0;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出模式
GPIO_InitStruct.Pull = GPIO_NOPULL;         // 不带内部上拉下拉电阻
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; // 输出速度低

HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

上述代码展示了如何通过`HAL_GPIO_Init()`函数来完成对特定GPIO引脚的初始化过程，这里选择了推挽输出模式作为例子说明[^3]。

#### 控制GPIO电平状态
一旦完成了必要的初始化之后就可以利用简单的API接口控制各个引脚的状态了。例如想要让某根线路上升沿触发，则可采用如下方式：

HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET);    // 将PA0置为高电平
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET);  // 将PA0置为低电平

另外还存在更简洁的形式如`GPIO_SetBits()`可以直接用来快速设定多个位为逻辑'1'[ ^2]:

GPIO_SetBits(GPIOA, GPIO_PIN_0 | GPIO_PIN_1);          // 同时将PA0和PA1设为高电平

值得注意的是当调用了这些改变I/O方向或读取当前值的操作后应当确保已经正确设置了相应的外设时钟源并且遵循官方文档给出的最佳实践指南来进行编码以获得最佳性能表现。