开发环境:
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单片机强大很多了。首先我们看看GD32的系统架构图:
GD32F20x系列器件是基于Arm® Cortex®-M3处理器的32位通用微控制器。 Arm® Cortex®-M3处理器包括三条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都是采用多时钟源的方法来解决这些问题,因此便有了GD32的时钟系统和时钟树。
GD32三个不同的时钟源可以用来驱动系统时钟(CK_SYS):
● IRC8M晶振时钟(高速内部时钟信号)
● HXTAL晶振时钟(高速外部时钟信号)
● PLL时钟
GD32有两个二级时钟源:
● 40kHz的低速内部IRC40K,它可以驱动独立看门狗,还可选择地通过程序选择驱动RTC。 RTC用于从停机/待机模式下自动唤醒系统。
● 32.768kHz的低速外部晶振LXTAL,可选择它用来驱动RTC。
每个时钟源在不使用时都可以单独被打开或关闭,这样就可以优化系统功耗。
3.2.3 GD32的时钟系统
GD32 芯片为了实现低功耗,设计了一个功能完善但却非常复杂的时钟系统。普通的MCU 一般只要配置好 GPIO 的寄存器就可以使用了,但 GD32还有一个步骤,就是开启外设时钟。
在 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的简书
BruceOu的知乎
资源获取方式
1.关注公众号[嵌入式实验楼]