GD32复用推挽输出

### GD32 微控制器复用推挽输出配置方法

对于GD32微控制器而言，在实现特定外设功能时，如定时器、串口等，通常需要将对应的GPIO引脚配置为复用推挽输出模式。这涉及到几个关键步骤：

#### GPIO初始化结构体定义
为了简化配置过程，GD32库函数提供了一个`gpio_init_struct`结构体用于存储关于某个具体GPIO端口及其引脚的各种参数设定。

struct gpio_init_struct {
    uint32_t gpio_mode;        /*!< Specifies the operating mode of the specified pin(s).
                                  This parameter can be a value of @ref GPIO_MODE */
    uint32_t gpio_out_type;    /*!< Specifies the out type of the specified pin(s).
                                  This parameter can be a value of @ref GPIO_OUTPUT_TYPE */
    uint32_t gpio_pull_up_down;/*< Specifies whether pull-up or pull-down resistor is enabled on the selected pins.
                                  This parameter can be a value of @ref GPIO_PULL_UP_DOWN */
    uint32_t gpio_bit_idx;     /*!< Specifies the port bit(s) to configure.  
                                  This parameter can be any combination of @ref GPIO_PIN */
};

#### 设置复用推挽输出模式
当目标是让某一GPIO引脚执行其复用功能（例如作为USART发送端TX），则需将其工作模式设置为复用推挽输出(`GPIO_MODE_AF_PP`)。此操作通过修改上述结构体中的成员变量完成，并调用相应的初始化接口应用这些更改[^1]。

// 定义并填充GPIO初始化结构体
struct gpio_init_struct usart_tx_gpio = {0};

usart_tx_gpio.gpio_mode       = GPIO_MODE_AF_PP;
usart_tx_gpio.gpio_out_type   = GPIO_OUTTYPE_PP;
usart_tx_gpio.gpio_pull_up_down= GPIO_PULL_NONE;
usart_tx_gpio.gpio_bit_idx    = GPIO_PINS_9;

// 初始化指定的GPIO端口和引脚
gpio_init(GPIOA, &usart_tx_gpio);

这段代码片段展示了如何针对USART_TX信号线所在的PA9引脚进行必要的配置，使其能够正常运作于复用推挽输出状态下。值得注意的是，这里假设USART已经完成了自身的初始化流程；同时确保所选引脚确实支持所需的复用功能是非常重要的[^3]。

另外需要注意的是，在某些情况下可能还需要进一步调整系统的AFIO(AHB peripheral alternate function I/O remapping control register)，以便正确映射所需的功能到具体的物理引脚上[^2]。