一交煞、簡介

最多可支持112個通用I/O引腳(GPIO)，分別為PA0 ~ PA15斟或，PB0 ~ PB15素征，PC0 ~ PC15，PD0 ~ PD15缕粹，PE0 ~ PE15稚茅，PF0 ~ PF15和PG0 ~ PG15，各片上設備用其來實現(xiàn)邏輯輸入/輸出功能平斩。每個GPIO端口有相關的控制和配置寄存器以滿足特定應用的需求亚享。外設GPIO引腳上的外部中斷在中斷/事件控制器（EXTI）中有相關的控制和配置寄存器。GPIO端口和其他的備用功能(AFs)共用引腳绘面，在特定的封裝下獲得最大的靈活性欺税。GPIO引腳通過配置相關的寄存器可以用作備用功能引腳，備用功能輸入/輸出都可揭璃。每個GPIO引腳可以由軟件配置為輸出(推挽或開漏)晚凿、輸入、外設的備用功能或者模擬模式瘦馍。每個GPIO引腳都可以配置為上拉歼秽、下拉或無上拉/下拉。除模擬模式外情组，所有的GPIO引腳都具備大電流驅動能力燥筷。

二、API說明

2.1 外設寄存器說明

GPIO寄存器列表如下表所示：

2.2 外設庫函數(shù)說明

以下 GPIO 接口位于 GD32F10x_Firmware_Library_V2.2.2\Firmware\GD32F10x_standard_peripheral\Include\gd32f10x_gpio.h院崇。

2.2.1 gpio_init

mode： IO模式，在GD32標準固件庫中底瓣，共有四種輸入模式谢揪，四種輸出模式，詳細列表如下：

speed： IO輸出速度最大值捐凭，詳細列表如下：

2.2.2 gpio_bit_set

2.2.3 gpio_bit_reset

2.2.4 gpio_bit_write

2.2.5 gpio_input_bit_get

2.2.6 gpio_pin_remap_config

remap： 重映射，詳細列表如下：

三、GPIO輸出

3.1 引腳確定

我使用的是 光子MINI-GD32F103RCT6 開發(fā)板

有個 IO 口為 PB4 的 LED 燈

在復位期間或復位之后另伍，備用功能并未激活鼻百，所有GPIO端口都被配置成輸入浮空模式，這種輸入模式禁用上拉(PU)/下拉(PD)電阻摆尝。但是復位后温艇，串行線調試端口（JTAG/Serial-Wired Debug pins）為輸入PU/PD模式：
PA15：JTDI為上拉模式；
PA14：JTCK / SWCLK為下拉模式堕汞；
PA13：JTMS / SWDIO為上拉模式勺爱；
PB4：NJTRST為上拉模式；
PB3：JTDO為浮空模式讯检。

所以PB4要當GPIO需要重映射

//管腳復用時鐘使能
rcu_periph_clock_enable(RCU_AF);
//PB4管腳默認是NJTRST琐鲁，要當GPIO，需要重映射
gpio_pin_remap_config(GPIO_SWJ_NONJTRST_REMAP, ENABLE)

3.2 編程要點

1. 使能 GPIO 端口時鐘
2. 初始化 GPIO 目標引腳為推挽輸出
3. 控制 GPIO 引腳輸出高人灼、低電平

3.3 外設寄存器方法

//GPIOB時鐘使能
rcu_periph_clock_enable(RCU_GPIOB);
//配置GPIO端口
gpio_init(GPIOB, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_4);

//引腳輸出低電平
GPIO_BC(GPIOB) = GPIO_PIN_4;
//引腳輸出高電平
GPIO_BOP(GPIOB) = GPIO_PIN_4;

3.4 外設庫函數(shù)方法

//GPIOB時鐘使能
rcu_periph_clock_enable(RCU_GPIOB);
//PB4配置成輸出
gpio_init(GPIOB, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_4);

//引腳輸出低電平
gpio_bit_reset(GPIOB, GPIO_PIN_4);
//引腳輸出高電平
gpio_bit_set(GPIOB, GPIO_PIN_4);
//引腳輸出低電平
gpio_bit_write(GPIOB, GPIO_PIN_4, RESET);
//引腳輸出高電平
gpio_bit_write(GPIOB, GPIO_PIN_4, SET);

四围段、GPIO輸入

4.1 引腳確定

我使用的是 光子MINI-GD32F103RCT6 開發(fā)板

有個 IO 口為 PA1 的按鍵

4.2 編程要點

1. 使能 GPIO 端口時鐘
2. 初始化 GPIO 目標引腳為輸入模式（由于硬件電路沒有外部上拉電阻，這里使用內部上拉輸入）
3. 檢測按鍵的狀態(tài)

4.3 外設庫函數(shù)方法

//GPIOA時鐘使能
rcu_periph_clock_enable(RCU_GPIOA);
//PA1配置成上拉輸入
gpio_init(GPIOA, GPIO_MODE_IPU, GPIO_OSPEED_50MHZ, GPIO_PIN_1);

//讀取引腳電平
gpio_input_bit_get(GPIOA, GPIO_PIN_1);

五投放、輪詢讀取按下按鍵奈泪，LED燈閃爍

5.1 board_gpio.c

/*********************************************************************
 * INCLUDES
 */
#include "gd32f10x.h"

#include "board_gpio.h"

/*********************************************************************
 * PUBLIC FUNCTIONS
 */
/*=========================================================================*/
/*                                   輸入                                  */
/*=========================================================================*/
/**
 @brief 按鍵驅動初始化
 @param 無
 @return 無
*/
void Key_GPIO_Init(void)
{
    // GPIO時鐘使能
    rcu_periph_clock_enable(RCU_GPIOA);
    // 配置為內部上拉輸入模式
    gpio_init(KEY1_GPIO_PORT, GPIO_MODE_IPU, GPIO_OSPEED_50MHZ, KEY1_GPIO_PIN);
}

/**
 @brief 獲取按鍵狀態(tài)
 @param keyNum -[in] 按鍵編號
 @return 1 - 按下；0 - 松開
*/
uint8_t Key_GPIO_Read(uint8_t keyNum)
{
    uint8_t value = 0;

    if(KEY1 == keyNum)
    {
        value = gpio_input_bit_get(KEY1_GPIO_PORT, KEY1_GPIO_PIN);
    }
//    else if(KEY2 == keyNum)
//    {
//        value = gpio_input_bit_get(KEY2_GPIO_PORT, KEY2_GPIO_PIN);
//    }

    return value;
}

/*=========================================================================*/
/*                                   輸出                                  */
/*=========================================================================*/
/**
 @brief LED燈驅動初始化
 @param 無
 @return 無
*/
void LED_GPIO_Init(void)
{
    // PB4管腳默認是NJTRST灸芳，要當GPIO涝桅，需要重映射
    rcu_periph_clock_enable(RCU_AF);                                    // 管腳復用時鐘使能
    gpio_pin_remap_config(GPIO_SWJ_NONJTRST_REMAP, ENABLE);
    
    // GPIO時鐘使能
    rcu_periph_clock_enable(RCU_GPIOB);
    // 配置為推挽輸出模式
    gpio_init(LED1_GPIO_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, LED1_GPIO_PIN);

    LED_GPIO_Write(LED1, LED_OFF);
}

/**
 @brief 配置LED燈工作模式
 @param ledNum -[in] LED燈編號
 @param ledMode -[in] 工作模式
 @return 無
*/
void LED_GPIO_Write(uint8_t ledNum, uint8_t ledMode)
{
    if(LED1 == ledNum)
    {
        gpio_bit_write(LED1_GPIO_PORT, LED1_GPIO_PIN, ledMode);
    }
//    else if(LED2 == ledNum)
//    {
//        gpio_bit_write(LED2_GPIO_PORT, LED2_GPIO_PIN, ledMode);
//    }
}

/**
 @brief 獲取LED燈工作模式
 @param ledNum -[in] LED燈編號
 @return 工作模式
*/
uint8_t LED_GPIO_Read(uint8_t ledNum)
{
    uint8_t ledMode = 0;
    if(LED1 == ledNum)
    {
        ledMode = gpio_output_bit_get(LED1_GPIO_PORT, LED1_GPIO_PIN);
    }
//    else if(LED2 == ledNum)
//    {
//        ledMode = gpio_output_bit_get(LED2_GPIO_PORT, LED2_GPIO_PIN, &ledMode);
//    }
    return ledMode;
}

5.2 board_gpio.h

#ifndef _BOARD_GPIO_H_
#define _BOARD_GPIO_H_

/*********************************************************************
 * INCLUDES
 */
#include "gd32f10x_gpio.h"
 
/*********************************************************************
 * DEFINITIONS
 */
/*=========================================================================*/
/*                                   輸入                                  */
/*=========================================================================*/
#define KEY1_GPIO_PORT                  GPIOA
#define KEY1_GPIO_PIN                   GPIO_PIN_1
#define KEY_OFF                         0x01
#define KEY_ON                          0x00
#define KEY1                            1
#define KEY2                            2

/*=========================================================================*/
/*                                   輸出                                  */
/*=========================================================================*/
#define LED1_GPIO_PORT                  GPIOB
#define LED1_GPIO_PIN                   GPIO_PIN_4
#define LED_OFF                         0x01
#define LED_ON                          0x00
#define LED1                            1
#define LED2                            2

/*********************************************************************
 * API FUNCTIONS
 */
void Key_GPIO_Init(void);
uint8_t Key_GPIO_Read(uint8_t keyNum);

void LED_GPIO_Init(void);
void LED_GPIO_Write(uint8_t ledNum, uint8_t ledMode);
uint8_t LED_GPIO_Read(uint8_t ledNum);

#endif /* _BOARD_GPIO_H_ */

5.3 main.c

#include "gd32f10x.h"
#include "systick.h"

#include "board_gpio.h"

int main(void)
{
    systick_config();//系統(tǒng)主頻108MHZ,采用外部晶振,由兩個宏決定(__SYSTEM_CLOCK_108M_PLL_HXTAL與HXTAL_VALUE)
    
    Key_GPIO_Init();// 按鍵模塊初始化
    LED_GPIO_Init();// LED燈模塊初始化
    
    while(1)
    {
        if(KEY_ON == Key_GPIO_Read(KEY1))
        {
            delay_1ms(100);//等待100ms
            LED_GPIO_Write(LED1, LED_ON);
            delay_1ms(100);//等待100ms
            LED_GPIO_Write(LED1, LED_OFF);
        }
    }
}

5.4 工程代碼

百度網(wǎng)盤：https://pan.baidu.com/s/1_tjTeP_xVNC-KdVDLbN-Ww?pwd=0h8m 提取碼：0h8m

? 由 Leung 寫于 2022 年 4 月 12 日

? 參考：GD32F103基礎教程—GPIO輸出實驗（五）
　　　　GD32實戰(zhàn)3__點亮LED燈