深入解析hal_gpio_writepin函数的用途

KMZEH • 2025-04-12 13:00 • 编程

一、基本介绍

/**
  * @brief  Write GPIO Output Data.
  * @param  gpio_periph: GPIO port peripheral, Select from enum @ref gpio_peripheral_define.
  * @param  pinx: GPIO port pin, Select from enum @ref gpio_pin_define.
  * @param  val: Data to be written to the port output data register.
  *   This parameter can be a value of @ref gpio_pin_state.
  * @retval None
  */

void hal_gpio_writepin(uint32_t gpio_periph, uint8_t pinx, bit_status bit_val);

hal_gpio_writepin函数是HAL库中关于GPIO的一个输出函数，主要作用是将某个引脚的电平状态进行设置，从而达到控制外部设备的目的。通过调用该函数，可以轻松地实现对开关、LED、电机等器件的操作。

二、参数介绍

hal_gpio_writepin函数有三个参数，下面我们分别介绍：

gpio_periph: GPIO端口的时钟。该参数从枚举gpio_peripheral_define中定义，可以选择PA、PB、PC、PD、PE、PF、PG等GPIO端口。
pinx: 选择要操作的GPIO引脚。该参数从枚举gpio_pin_define中定义，可以选择0~15之间的数字，代表要设置的引脚。（例如选择PA0，对应的枚举值就是GPIO_PIN_0）
bit_val: GPIO要设置的输出电平状态。该参数的取值可以是GPIO_PIN_RESET或GPIO_PIN_SET，分别代表低电平和高电平。

三、函数原理

在单片机中，GPIO引脚都有一个相应的寄存器，用于控制引脚的电平。在应用程序中，我们可以通过修改对应的寄存器来改变引脚电平。hal_gpio_writepin函数作用就是将用户传入的电平值写入对应的寄存器中，从而实现改变引脚电平的目的。

四、调用示例

下面是一个简单的示例程序，用于将PA5引脚的电平状态设置为高电平：

#include "gd32f10x.h"

int main(void)
{
    /* 时钟初始化 */
    rcu_periph_clock_enable(RCU_GPIOA);
    
    /* GPIO初始化 */
    gpio_direction_output(GPIOA, GPIO_PIN_5);
    hal_gpio_writepin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);
    
    /* 此处可以加入无限循环，保证程序不会退出，从而保证LED一直处于亮的状态 */
}

在程序中，首先需要初始化PA端口的时钟，然后将PA5引脚设置为输出模式，最后通过调用hal_gpio_writepin函数将PA5的输出电平状态设置为高电平，从而实现控制LED亮的目的。

五、总结

通过以上对于hal_gpio_writepin函数的详细介绍，我们可以清晰地了解到这个函数的作用、参数和实现原理。同时，我们还给出了一个简单的程序示例，通过这个示例，我们可以更好地掌握这个函数的使用方法和注意事项，进而在实际开发中更加得心应手。

原创文章，作者：KMZEH，如若转载，请注明出处：https://www.506064.com/n/368815.html