MDK：Keil 5.30 MCU：GD32F207IK
上一章通过控制GPIO高低电平实现了流水灯，但只告诉大家怎么做，怎么实现流水灯，本文将进行深入分析GPIO对流水灯的调用逻辑和数据结构进行了深入研究。
3.1 GPIO配置概述
前一章一个个讲解GPIO当然，关于配置过程和核心寄存器GPIO上一章列出的寄存器远不止我，还有很多。《GD32F20x_User_Manual》中GPIO相关内容。
根据之前的实现GPIO本文总结如下：
要想控制LED亮灭，需要做以上三件事:使能时钟，配置GPIO参数，最后循环控制GPIO流水灯的效果可以通过高低电平来实现，GPIO这里就不说寄存器了。更详细的寄存器描述可以看官方手册。我们先来看看。GD32的时钟。
3.2 GD32的时钟系统
3.2.1 GD32的系统架构
GD32的系统架构比51单片机强大得多。首先，让我们看看GD系统架构图32：
GD32F20x基于系列设备Arm? Cortex?-M32位通用微控制器处理器。 Arm? Cortex?-M三个处理器包括三个AHB总线分别称为I-CODE总线、 D-Code总线和系统总线。
下面我们具体讲解一下图中几条总线的知识:
① ICode 总线：总线将 M3 内核指令总线与闪存指令接口相连，指令预先在总线上完成。
② DCode 总线：总线将 M3 内核的 DCode 总线连接到闪存存储器的数据接口，并在总线上完成常量加载和调试访问。
③ 系统总线：总线连接 M3 从内核系统总线到总线矩阵，总线矩阵协调内核和 DMA 间访问。
④ DMA 总线：总线将 DMA 的 AHB 主控接口与总线矩阵相连，总线矩阵协调 CPU 的DCode 和 DMA 到 SRAM,访问闪存和外设。
⑤ 总线矩阵：总线矩阵协调内核系统总线和 DMA 主控总线之间的访问仲裁采用轮换算法。
⑥ AHB/APB 桥：这两座桥在 AHB 和 2 个 APB 同步连接在总线之间，APB1 操作速度限于60MHz,APB2 全速运行。
在开始学习系统架构的知识时 GD32 只需要一个大概的了解，大致知道是什么情况。
3.2.2 GD32时钟架构
时钟是整个处理器运行的基础，时钟信号推动处理器各部分执行相应的指令。时钟系统是CPU脉搏，决定CPU速度，就像心跳一样 只有心跳，人们才能做其他事情，单片机有时钟，可以操作执行指令，可以做其他处理 (点灯，串口，ADC)，时钟的重要性不言而喻。
当我们学习51台单片机时，其最小系统必须有晶体振动电路，这是单片机的时钟来源，晶体振动频率直接影响单片机的处理速度。GD32比51单片机复杂得多，不仅外设很多，还有四个时钟来源。然而，当我们实际使用它时，我们只使用有限的外围设备。使用任何外围设备都需要时钟才能启动，但并非所有外围设备都需要系统时钟的高频。为了与不同速度的设备兼容，一些高速和低速设备必然会造成浪费。此外，同一电路的时钟越快，功耗越快，抗电磁干扰能力越弱，所以比较复杂MCU这些问题都是通过多时钟源来解决的，所以有GD时钟系统和时钟树32。
GD三个不同的时钟源可用于驱动系统时钟(CK_SYS)：
● IRC8M晶振时钟(高速内部时钟信号) ● HXTAL晶振时钟(高速外部时钟信号) ● PLL时钟
GD三二级时钟源有两个：
● 40kHz的低速内部IRC40K，它可以驱动独立看门狗，也可以通过程序选择驱动RTC。 RTC用于在停机/待机模式下自动唤醒系统。 ● 32.768kHz低速外部晶振LXTAL，可选用于驱动RTC。 不使用时，每个时钟源都可以单独打开或关闭，以优化系统功耗。
3.2.3 GD32的时钟系统
GD32 为了实现低功耗，芯片设计了一个功能完善但非常复杂的时钟系统。MCU 一般只要配置好 GPIO 可以使用寄存器，但是 GD另一步是打开外设时钟。
在 GD32可分为五种时钟源，即 IRC8M、HXTAL、IRC40K、LXTAL、PLL。从时钟频率来看，可分为高速时钟源和低速时钟源 IRC8M， HXTAL以及 PLL 是高速时钟，IRC40K和 LXTAL是低速时钟。来源可分为外部时钟源和内部时钟源。外部时钟源是通过连接晶体振动从外部获得的时钟源 HXTAL和 LXTAL是外部时钟源，其他是内部时钟源。
让我们来看看 GD32 的 5 个时钟源，我们按照图中红圈标记的顺序解释顺序：
①IRC8M是高速内部时钟，RC 频率为的振荡器 8MHz。 ②HXTAL是高速外部时钟，可连接石英/陶瓷谐振器或外部时钟源，频率范围为4MHz~32MHz。我们的开发板是连接的 25M 的晶振。使用有源晶振时，时钟从 OSC_IN 引脚进入， OSC_OUT 当选择无源晶振时，时钟从 OSC_IN 和 OSC_OUT 并配备谐振电容。当确定 PLL 时钟来源时， HXTAL不分频或不分频 2 寄存器由时钟配置 CFG0 的位 17。 ③IRC40K是低速内部时钟，RC 频率为的振荡器 40kHz。独立看门狗的时钟源只能是 IRC40K，同时 IRC40K还可以作为 RTC 的时钟源。 ④LXTAL是低速外部时钟，连接频率为 32.768kHz 石英晶体。这主要是 RTC 的时钟源。 ⑤PLL 可选择锁相环倍频输出的时钟输入源 IRC8M、HXTAL。倍频可选为2~但其最大输出频率不得超过32倍 120MHz。
图中我们用 A~E 标示我们要讲解的地方。
A. MCO 是 GD32 时钟输出IO，可选择时钟信号输出， 可以选择为 PLL 输出的 2 分频、IRC8M、HXTAL、或系统时钟。此时钟可用于为其他外部系统提供时钟源。 B. 这里是 RTC 从图中可以看出时钟源，RTC 可选择时钟源 IRC40K，以及HXTAL的 128 分频。 C. 从图中可以看出 C 处 USB 时钟来自 PLL 时钟源。 GD32 全速功能之一 USB 该模块的串行接口引擎需要一个频率 48MHz 时钟源。时钟源只能从 PLL 可选择输出端获取 1/1.5/2/2.5 分频。 D. D 处就是 GD32 的系统时钟 SYSCLK，它是供 GD32 大多数部件工作的时钟源。系统时钟可以选择为 PLL 输出、 IRC8M或者 HXTAL。系统时钟最大频率为 120MHz，当然，你也可以超频，但一般来说，没有必要为了系统稳定而冒险超频。 E. 这里的 E 指所有其他外设。
从时钟图可以看出，所有其他外设时钟的最终来源都是 SYSCLK。SYSCLK 通过 AHB 对每个模块进行分频。这些模块包括：
①AHB 总线、内核、内存和 DMA 使用的 HCLK 时钟。 ②通过 8 分频后送给 Cortex 系统定时器时钟，即 systick 了。 ③直接送给 Cortex 空闲时钟 FCLK。 ④送给 APB1 分频器。APB1 一路输出分频器供应 APB1 外设使用(PCLK1，最大频率 60MHz)，另一给定时器(Timer)使用。 ⑤送给 APB2 分频器。APB2 分频器分频输出一路供APB2外设使用(PCLK2，最大频率 120MHz)，另一给定时器(Timer)使用。
需要理解的是 APB1 和 APB2 的区别， APB1 上述连接是低速外设，包括电源接口、备份接口、 CAN、 USB、 I2C0、 I2C1、 UART1、 UART2 等等， APB2 上面连接的是高速外设，包括 UART0、 SPI0、 Timer0、 ADC0、 ADC1、所有普通 IO 口(PA~PG)、第二功能 IO 口等。
不同的总线有不同的频率，不同的外设挂在不同的总线下了更适合初学者，笔者总结了常用外设与总线的对应关系如下:
SystemInit()函数中设置的系统时钟大小:
? SYSCLK(系统时钟) =120MHz ? AHB 总线时钟(使用 SYSCLK) =120MHz ? APB1 总线时钟(PCLK1) =60MHz ? APB2 总线时钟(PCLK2) =120MHz ? PLL 时钟 =120MHz
值得注意的是，GD32F207系列有多个PLL，具体参考源码。
3.2.4 GD32时钟配置分析
既然时钟很清楚，那就回到上一章吧置时钟的代码：
/*enable the LED clock*/
rcu_periph_clock_enable(RCU_GPIOF );;
rcu_periph_clock_enable就是配置时钟的函数，函数原型如下：
/*! \brief enable the peripherals clock \param[in] periph: RCU peripherals, refer to rcu_periph_enum only one parameter can be selected which is shown as below: \arg RCU_GPIOx (x=A,B,C,D,E,F,G,H,I): GPIO ports clock \arg RCU_AF : alternate function clock \arg RCU_CRC: CRC clock \arg RCU_DMAx (x=0,1): DMA clock \arg RCU_ENET: ENET clock \arg RCU_ENETTX: ENETTX clock \arg RCU_ENETRX: ENETRX clock \arg RCU_USBFS: USBFS clock \arg RCU_EXMC: EXMC clock \arg RCU_TIMERx (x=0,1,2,3,4,5,6,7,8,9,10,11,12,13): TIMER clock \arg RCU_WWDGT: WWDGT clock \arg RCU_SPIx (x=0,1,2): SPI clock \arg RCU_USARTx (x=0,1,2,5): USART clock \arg RCU_UARTx (x=3,4,6,7): UART clock \arg RCU_I2Cx (x=0,1,2): I2C clock \arg RCU_CANx (x=0,1): CAN clock \arg RCU_PMU: PMU clock \arg RCU_DAC: DAC clock \arg RCU_RTC: RTC clock \arg RCU_ADCx (x=0,1,2): ADC clock \arg RCU_SDIO: SDIO clock \arg RCU_BKPI: BKP interface clock \arg RCU_TLI: TLI clock \arg RCU_DCI: DCI clock \arg RCU_CAU: CAU clock \arg RCU_HAU: HAU clock \arg RCU_TRNG: TRNG clock \param[out] none \retval none */
void rcu_periph_clock_enable(rcu_periph_enum periph)
{
RCU_REG_VAL(periph) |= BIT(RCU_BIT_POS(periph));
}
整个函数就一个参数，其参数就是具体的外设时钟，整个函数很简单，就是打开具体的外设时钟。 参数periph传入值是通过宏来定义的，这样的好处也是便于移植，如果换了MCU，架构一样，只需要就该底层驱动就行，不需要更改上层应用，这样就提高了开发效率。言归正传，我们传入的RCU_GPIOC定义如下。
RCU_GPIOF是一个枚举类型。我们继续追溯以上的宏。
/* constants definitions */
/* define the peripheral clock enable bit position and its register index offset */
#define RCU_REGIDX_BIT(regidx, bitpos) (((uint32_t)(regidx) << 6) | (uint32_t)(bitpos))
#define RCU_REG_VAL(periph) (REG32(RCU + ((uint32_t)(periph) >> 6)))
#define RCU_BIT_POS(val) ((uint32_t)(val) & 0x1FU)
#define APB2EN_REG_OFFSET 0x18U /*!< APB2 enable register offset */
#define BIT(x) ((uint32_t)((uint32_t)0x01U<<(x)))
/* RCU definitions */
#define RCU RCU_BASE
#define RCU_BASE (AHB1_BUS_BASE + 0x00009000U) /*!< RCU base address */
#define AHB1_BUS_BASE ((uint32_t)0x40018000U) /*!< ahb1 base address */
以上宏定义就是整个时钟初始化相关的宏定义了，将其带入函数中。RCU的基地址就是0x40018000+0x9000。可以从GD32参考手册中获取。
AHB1总线的基地址是0x40018000。
RCU偏移是0x9000。
RCU_REG_VAL(RCU_GPIOC)最终的结果是0x40021018。 宏定义BIT就是获取GPIO具体的使能位。
BIT(RCU_BIT_POS(RCU_GPIOF))最终的结果就是0x64。
最终的函数替换后如下：
0x40021018 |= 0x64;
都是宏定义直接替换就行，还是比较简单。
这里需要注意RCU_REGIDX_BIT宏定义。
#define RCU_REGIDX_BIT(regidx, bitpos) (((uint32_t)(regidx) << 6) | (uint32_t)(bitpos))
该宏定义就是将要配置的寄存器偏移和bit位绑定在一起，然后再通过以下宏定义分开偏移和bit位。
#define RCU_REG_VAL(periph) (REG32(RCU + ((uint32_t)(periph) >> 6)))
#define RCU_BIT_POS(val) ((uint32_t)(val) & 0x1FU)
RCU的APB2使能寄存器如下：
这里配置GPIOF的时钟，需要将第7位置1，因此转换成10进制就是64，和代码就匹配起来了。 GD32的固件库和STM32的固件库还是有一些差别的，但是不管如何，最终都是配置的寄存器，只是STM32通过结构体对外设进行了封装，GD32是通过宏定义直接替换，偏向于直接操作寄存器。
3.3 GD32的地址映射
我们先看看51 单片机中是怎么做的，51 单片机开发中会引用一个 reg51.h 的头文件，51单片机是通过以下方式将名字和寄存器联系起来的：
sfr P0 =0x80;
sfr 也是一种扩充数据类型，占用一个内存单元，值域为 0～255。利用它可以访问 51 单片机内部的所有特殊功能寄存器。如用 sfr P1 = 0x90 这一句定义 P1 为 P1 端口在片内的寄存器。然后我们往地址为 0x80 的寄存器设值的方法是： P0=value；通过改变value的值来控制单片机。
所谓地址映射，就是将芯片上的存储器甚至 I/O 等资源与地址建立一一对应的关系。如果某地址对应着某寄存器，我们就可以运用 C 语言的指针来寻址并修改这个地址上的内容，从而实现修改该寄存器的内容。Cortex-M的地址映射也是类似的。Cortex-M有 32 根地址线，所以它的寻址空间大小为 2 32 bit=4 GB。ARM 公司设计时，预先把这 4 GB 的寻址空间大致地分配好了。它把从 0x40000000 至 0x5FFFFFFF（ 512 MB）的地址分配给片上外设。通过把片上外设的寄存器映射到这个地址区，就可以简单地以访问内存的方式，访问这些外设的寄存器，从而控制外设的工作。这样，片上外设可以使用 C 语言来操作。
gd32f10x.h 这个文件中重要的内容就是把 GD32 的所有寄存器进行地址映射。如同51 单片机的 <reg51.h> 头文件一样，gd32f10x.h 像一个大表格，我们在使用的时候就是通过宏定义进行类似查表的操作，但是这样操作会很麻烦，而且32位的MCU寄存器很多，非常不方便。于是就有了现在的固件库。
在这里我们以流水灯中的 GPIOB 为例进行剖析，如果是其他的 IO 端口，则改成相应的地址即可。在这个文件中一系列宏实现了地址映射。
#define APB2_BUS_BASE ((uint32_t)0x40010000U) /*!< apb2 base address */
#define GPIO_BASE (APB2_BUS_BASE + 0x00000800U) /*!< GPIO base address */
这几个宏定义是从文件中的几个部分抽离出来的，具体的内容读者可参考gd32f10x.h 源码。 宏APB2_BUS_BASE指向的地址为 0x40010000。这个 APB2_BUS_BASE宏是什么地址呢？GD32 不同的外设是挂载在不同的总线上的。GD32 芯片有 AHB 总线、APB2总线和 APB1 总线，挂载在这些总线上的外设有特定的地址范围。其中像 GPIO、串口 1、ADC 及部分定时器是挂载在称为 APB2 的总线上，挂载到APB2 总 线上的外设地址空间是从0x40010000 至 0x40013FFF地址。这里的第一个地址，也就是 0x40010000，称为 APB2_BUS_BASE（APB2 总线外设基地址）。
而 APB2 总线基地址相对于外设基地址的偏移量为 0x10000 个地址，即为 APB2 相对外设基地址的偏移地址。
最后到了宏 GPIO_BASE，宏展开为 APB2_BUS_BASE加上偏移量 0x800得到了 GPIO端口的寄存器组的基地址。
在gd32f20x_gpio.h 文件，我们还可以发现有关各个 GPIO 基地址的宏。
/* GPIOx(x=A,B,C,D,E,F,G,H,I) definitions */
#define GPIOA (GPIO_BASE + 0x00000000U) /*!< GPIOA bsae address */
#define GPIOB (GPIO_BASE + 0x00000400U) /*!< GPIOB bsae address */
#define GPIOC (GPIO_BASE + 0x00000800U) /*!< GPIOC bsae address */
#define GPIOD (GPIO_BASE + 0x00000C00U) /*!< GPIOD bsae address */
#define GPIOE (GPIO_BASE + 0x00001000U) /*!< GPIOE bsae address */
#define GPIOF (GPIO_BASE + 0x00001400U) /*!< GPIOF bsae address */
#define GPIOG (GPIO_BASE + 0x00001800U) /*!< GPIOG bsae address */
#define GPIOH (GPIO_BASE + 0x00006C00U) /*!< GPIOH bsae address */
#define GPIOI (GPIO_BASE + 0x00007000U) /*!< GPIOI bsae address */
除了 GPIOF寄存器组的地址，还有 GPIOA、GPIOB和 GPIOD 的地址，并且这些地址是不一样的。前面提到，每组 GPIO 都对应着独立的一组寄存器，查看 GD32 的数据手册。 注意到这个说明中有一个偏移地址：0x400，这里的偏移地址是相对哪个地址的偏移呢？下面进行举例说明。
3.4固件库对寄存器的封装
GD的工程师用结构体的形式封装了寄存器组，在gd32f20x_gpio.h文件定义的。
/* GPIOx(x=A,B,C,D,E,F,G,H,I) definitions */
#define GPIOA (GPIO_BASE + 0x00000000U) /*!< GPIOA bsae address */
#define GPIOB (GPIO_BASE + 0x00000400U) /*!< GPIOB bsae address */
#define GPIOC (GPIO_BASE + 0x00000800U) /*!< GPIOC bsae address */
#define GPIOD (GPIO_BASE + 0x00000C00U) /*!< GPIOD bsae address */
#define GPIOE (GPIO_BASE + 0x00001000U) /*!< GPIOE bsae address */
#define GPIOF (GPIO_BASE + 0x00001400U) /*!< GPIOF bsae address */
#define GPIOG (GPIO_BASE + 0x00001800U) /*!< GPIOG bsae address */
#define GPIOH (GPIO_BASE + 0x00006C00U) /*!< GPIOH bsae address */
#define GPIOI (GPIO_BASE + 0x00007000U) /*!< GPIOI bsae address */
有了这些宏，我们就可以定位到具体的寄存器地址，gd32f10x_gpio.h 文件中定义了以下类型的宏定义。
/* GPIO registers definitions */
#define GPIO_CTL0(gpiox) REG32((gpiox) + 0x00000000U) /*!< GPIO port control register 0 */
#define GPIO_CTL1(gpiox) REG32((gpiox) + 0x00000004U) /*!< GPIO port control register 1 */
#define GPIO_ISTAT(gpiox) REG32((gpiox) + 0x00000008U) /*!< GPIO port input status register */
#define GPIO_OCTL(gpiox) REG32((gpiox) + 0x0000000CU) /*!< GPIO port output control register */
#define GPIO_BOP(gpiox) REG32((gpiox) + 0x00000010U) /*!< GPIO port bit operation register */
#define GPIO_BC(gpiox) REG32((gpiox) + 0x00000014U) /*!< GPIO bit clear register */
#define GPIO_LOCK(gpiox) REG32((gpiox) + 0x00000018U) /*!< GPIO port configuration lock register */
这里定义了 7 个宏定义，两个宏之间是4 个字节地址的偏移量。
0x010偏移量正是 GPIOx_BOP寄存器相对于所在寄存器组的偏移地址。
通过类似的方式，我们就可以给具体的寄存器写上适当的参数以控制 GD32 了。 这样我们就可以通过库函数实现了GPIO的初始化了。
/*! \brief GPIO parameter initialization \param[in] gpio_periph: GPIOx(x = A,B,C,D,E,F,G,H,I) \param[in] mode: gpio pin mode only one parameter can be selected which is shown as below: \arg GPIO_MODE_AIN: analog input mode \arg GPIO_MODE_IN_FLOATING: floating input mode \arg GPIO_MODE_IPD: pull-down input mode \arg GPIO_MODE_IPU: pull-up input mode \arg GPIO_MODE_OUT_OD: GPIO output with open-drain \arg GPIO_MODE_OUT_PP: GPIO output with push-pull \arg GPIO_MODE_AF_OD: AFIO output with open-drain \arg GPIO_MODE_AF_PP: AFIO output with push-pull \param[in] speed: gpio output max speed value only one parameter can be selected which is shown as below: \arg GPIO_OSPEED_10MHZ: output max speed 10MHz \arg GPIO_OSPEED_2MHZ: output max speed 2MHz \arg GPIO_OSPEED_50MHZ: output max speed 50MHz \param[in] pin: GPIO pin one or more parameters can be selected which are shown as below: \arg GPIO_PIN_x(x=0..15), GPIO_PIN_ALL \param[out] none \retval none */
void gpio_init(uint32_t gpio_periph, uint32_t mode, uint32_t speed, uint32_t pin)
{
uint16_t i;
uint32_t temp_mode = 0U;
uint32_t reg = 0U;
/* GPIO mode configuration */
temp_mode = (uint32_t)(mode & ((uint32_t)0x0FU));
/* GPIO speed configuration */
if(((uint32_t)0x00U) != ((uint32_t)mode & ((uint32_t)0x10U))) {
/* output mode max speed: 10MHz, 2MHz, 50MHz */
temp_mode |= (uint32_t)speed;
}
/* configure the eight low port pins with GPIO_CTL0 */
for(i = 0U; i < 8U; i++) {
if((1U << i) & pin) {
reg = GPIO_CTL0(gpio_periph);
/* clear the specified pin mode bits */
reg &= ~GPIO_MODE_MASK(i);
/* set the specified pin mode bits */
reg |= GPIO_MODE_SET(i, temp_mode);
/* set IPD or IPU */
if(GPIO_MODE_IPD == mode) {
/* reset the corresponding OCTL bit */
GPIO_BC(gpio_periph) = (uint32_t)((1U << i) & pin);
} else {
/* set the corresponding OCTL bit */
if(GPIO_MODE_IPU == mode) {
GPIO_BOP(gpio_periph) = (uint32_t)((1U << i) & pin);
}
}
/* set GPIO_CTL0 register */
GPIO_CTL0(gpio_periph) = reg;
}
}
/* configure the eight high port pins with GPIO_CTL1 */
for(i = 8U; i < 16U; i++) {
if((1U << i) & pin) {
reg = GPIO_CTL1(gpio_periph);
/* clear the specified pin mode bits */
reg &= ~GPIO_MODE_MASK(i - 8U);
/* set the specified pin mode bits */
reg |= GPIO_MODE_SET(i - 8U, temp_mode);
/* set IPD or IPU */
if(GPIO_MODE_IPD == mode) {
/* reset the corresponding OCTL bit */
GPIO_BC(gpio_periph) = (uint32_t)((1U << i) & pin);
} else {
/* set the corresponding OCTL bit */
if(GPIO_MODE_IPU == mode) {
GPIO_BOP(gpio_periph) = (uint32_t)((1U << i) & pin);
}
}
/* set GPIO_CTL1 register */
GPIO_CTL1(gpio_periph) = reg;
}
}
}
然后再main函数中调用gpio_init()函数接口对GPIO初始化了。
通过对时钟和GPIO的分析，我想大家已经对固件的逻辑有了一定的认识，从本质上讲，都是在配置寄存器，只是地址和值不同罢了，而固件库就是对寄存器配置的封装，便于开发者调用。
值得注意的是，GD32的固件库并没有使用结构体来对寄存器组进行封装，全程用的宏定义，这点和STM32有很大的不同。
欢迎访问我的网站
BruceOu的哔哩哔哩 BruceOu的主页 BruceOu的博客 BruceOu的CSDN博客 BruceOu的简书 BruceOu的知乎
资源获取方式
1.关注公众号[] 2.在公众号回复关键词[]获取资料提取码