GD32F10x到GD32F1x0的软件移植说明
1、
移植前准备工作。
将原有的ST的10x的库替换成我们GD的库（可以从demo中找到），包括系统头文件、外设库文件以及启动文件等，当前给客户提供的库都是以stm32f0xx命名，这是我们在ST的10x和0xx的外设库的基础上修改的，完全可以正常使用，后续我们会推出自己的库。开发环境的device选择和flash配置可以有两种方式，一种方式是直接device中选择ST的STM32F100C8，flash配置选择ST的K的flash配置文件；另一种方式是使用我们提供的GD的GD32F1x0的device（需要事先在keil安装目录下添加我们GD的配置文件），flash配置选择我们GD的K flash配置文件，其他配置可保持与之前相同不用改动。如果选择GD的配置文件，需要操作的步骤如下（假如keil的安装路径为：C:\\Keil）：
① 拷贝 UV4.cdb 到 C:\\Keil\\UV4。
② 拷贝 GD32F1x0_.FLM 到 C:\\Keil\\ARM\\Flash。 ③ C:\\Keil\\ 下创建文件夹命名“GD” 。 ④ GD 文件夹下创建文件夹命名“GD32F1x0”。
⑤ 拷贝 GD32F1x0.SFR 到 C:\\Keil\\ARM\\SFD\\GD\\GD32F1x0。
这样，在keil的device界面，就可以找到GD32F1x0的device，如图1.1所示。
图1.1 选择GD32F1x0的device
图1.2 flash配置文件及路径说明
2、 所有模块的GPIO初始化部分。
1x0相对于10x系列最大的改动在GPIO部分，主要有以下三点： 2.1 GPIO时钟总线配置区别。
之前10x系列的GPIO ABCDF都挂在了APB2总线上，而1x0的GPIO口都挂在了AHB总线上，所以在打开GPIO ABCDF的时钟的时候就要注意，如下：
比如使能GPIOA时钟：
10x下配置为：RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA,ENABLE); 1x0下需改为：RCC_AHBPeriphClockCmd(RCC_AHBPeriph_GPIOA,ENABLE);
GPIOB、C、D、F的时钟使能以此类推。 2.2 GPIO口复用配置区别。
1x0系列和10x系列的IO口复用配置模式不同。具体对比说明如下：
比如USART1的GPIO口配置，可以映射到PA9和PA10，也可以映射到PB6和PB7。 2.2.1 10x配置USART1的GPIO口，大概过程如下（以PA9和PA10为例）： 2.2.1.1 首先使能USART1、GPIOA和AFIO的时钟。
RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA , ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO , ENABLE); 2.2.1.2 然后配置PA9和PA10的模式。
GPIO_InitTypeDef GPIO_InitStructure;
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_Init(GPIOA, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &GPIO_InitStructure);
1x0无需这一步
复用模式配置
2.2.1.3 最后配置串口相应参数，这部分和1x0完全相同，就不列出来了。 2.2.2 1x0配置USART1的GPIO口，大概过程如下（以PA9和PA10为例）： 2.2.1.1 首先使能USART1、GPIOA的时钟。
RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE); RCC_AHBPeriphClockCmd(RCC_AHBPeriph_GPIOA , ENABLE); 2.2.1.2 然后配置PA9和PA10的模式。
GPIO_InitTypeDef GPIO_InitStructure; GPIO_PinAFConfig( GPIOA , GPIO_PinSource9, GPIO_AF_1 ); GPIO_PinAFConfig( GPIOA , GPIO_PinSource10, GPIO_AF_1 ); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9 | GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_OType = GPIO_OType_PP; GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL; GPIO_Init( GPIOA , &GPIO_InitStructure); 如果将USART1映射到PB6和PB7，则复用模式配置如下： GPIO_PinAFConfig( GPIOB , GPIO_PinSource6, GPIO_AF_0 ); GPIO_PinAFConfig( GPIOB , GPIO_PinSource7, GPIO_AF_0 );
复用模式配置 此处不需要再配置PA10为浮空输入了
至于为什么PA9、PA10映射到GPIO_AF_1，PB6和PB7映射到GPIO_AF_0，需要查看1x0的datasheet，如下图：
图2.1 PB复用功能说明
所以，关于GPIO口的复用配置都需要参考datasheet来完成。 2.2.2.3 最后配置串口相应参数，这部分和10x完全相同，就不列出来了。 2.3 GPIO口模式配置
10x系列的GPIO口有8种模式，如下图：
图2.2 10x系列GPIO口8种模式
而1x0系列的GPIO口配置在10x系列的基础上，按输入输出、推挽开漏、上拉下拉模式分成了三个结构体，相较10x系列而言，组合方式更加自由，如下图：
图2.3 1x0系列GPIO口模式
例如：10x系列配置某个GPIO口为推挽输出
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP ; 1x0系列中，就变成了两条语句：
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT; GPIO_InitStructure.GPIO_OType= GPIO_OType_PP; 又如：10x系列配置某个GPIO口为下拉输入： GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPD ; 1x0系列中，就变成了：
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN;
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_DOWN;
3、 外设中断部分
1x0相对于10x系列增加了一些模块（如SYSCFG、TSC、CEC等），删减了一些模块（如1x0只有一个ADC、最多两路DMA等），因此1x0的中断向量表的名称包括位置相对于10x系列都有很大改变。很多客户都反映移植中经常遇到的问题就是无法进入中断。10x和1x0系列的中断向量表的对比如下：
表3.1 10x和1x0中断向量表对比说明
移植过程中，要注意的一点通常是外设中断名称的修改，举几个例子：
3.1 TIM1，如果用作6路PWM输出，需要在中断处理函数的头文件（比如stm32f0xx_it.h）中，把原来的TIM1的中断函数声明改为：void TIM1_BRK_UP_TRG_COM_IRQHandler (void); 在中断处理函数源文件（比如stm32f0xx_it.c）中，把TIM1的中断函数名称也改为： void TIM1_BRK_UP_TRG_COM_IRQHandler (void) {
/*原来的代码*/ }
然后在定义TIM1中断分组优先级的相应代码里（一般是在main函数中），把中断通道改成如下设置：
NVIC_InitStructure1.NVIC_IRQChannel=TIM1_BRK_UP_TRG_COM_IRQn;
一般改这三个地方应该就可以正常进入中断了。剩下的外设以此类推。 3.2 如果有USART1中断，三个地方分别改为： void USART1_IRQHandler (void); void USART1_IRQHandler (void) {
/*原来的代码*/ }
NVIC_InitStructure1.NVIC_IRQChannel=USART1_IRQn; 3.3 如果有DMA中断，如果是通道1，三个地方分别改为： void DMA1_Channel1_IRQHandler (void);
void DMA1_Channel1_IRQHandler (void) {
/*原来的代码*/ }
NVIC_InitStructure1.NVIC_IRQChannel=DMA1_Channel1_IRQn; 3.4 如果有ADC中断，三个地方分别改为： void ADC1_COMP_IRQHandler (void); void ADC1_COMP_IRQHandler (void) {
/*原来的代码*/ }
NVIC_InitStructure1.NVIC_IRQChannel=ADC1_COMP_IRQn; 3.5 如果有TIM2中断，三个地方修改如下： void TIM2_IRQHandler (void); void TIM2_IRQHandler (void) {
/*原来的代码*/ }
NVIC_InitStructure1.NVIC_IRQChannel=TIM2_IRQn;
4、 外中断线EXIT部分
以配置PB13的下降沿中断为例： 10x的配置如下：
EXTI_InitTypeDef EXTI_InitStructure;
GPIO_EXTILineConfig( GPIO_PortSourceGPIOB, GPIO_PinSource13 ); EXTI_ClearITPendingBit( EXTI_Line13 ); EXTI_InitStructure.EXTI_Line = EXTI_Line13;
EXTI_InitStructure.EXTI_Mode = EXTI_Mode_Interrupt; EXTI_InitStructure.EXTI_Trigger = EXTI_Trigger_Falling ; EXTI_InitStructure.EXTI_LineCmd = ENABLE; EXTI_Init(&EXTI_InitStructure); 1x0的配置如下： EXTI_InitTypeDef EXTI_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_SYSCFG, ENABLE); SYSCFG_EXTILineConfig( EXTI_PortSourceGPIOB, EXTI_PinSource13); EXTI_ClearITPendingBit( EXTI_Line13 ); EXTI_InitStructure.EXTI_Line = EXTI_Line13;
EXTI_InitStructure.EXTI_Mode = EXTI_Mode_Interrupt; EXTI_InitStructure.EXTI_Trigger = EXTI_Trigger_Falling ;
1x0的外中断线的配置是在SYSCFG模块中完成，而10x直接在GPIO模块完成 EXTI_InitStructure.EXTI_LineCmd = ENABLE; EXTI_Init(&EXTI_InitStructure);
5、 DMA模块
1x0和10x相比，DMA模块的配置上完全相同，唯一有区别的是外设的DMA通道可能略有差别。下面两张图对比了二者DMA1映射的区别：
图5.1 10x系列DMA1外设通道一览
图5.2 1x0系列的DMA外设通道一览
注：括号里的（1）、（2）说明如下：
（1） SYSCFG_R1寄存器中的对应重映射控制位被清0时，此请求被映射到该通道。 （2） SYSCFG_R1寄存器中的对应重映射控制位被置1时，此请求被映射到该通道。 其中（1）为缺省设置。
DMA模块的区别反映在软件代码是就是通道配置的区别，例如USART1的Rx在10x系列中在DMA1的通道5，但是在1x0系列中，缺省模式下映射到DMA1的通道3。如果使用USART1的DMA接收方式，相关配置的修改如下：
10x中：DMA_Init(DMA1_Channel5, &DMA_InitStructure); DMA_Cmd(DMA1_Channel5, ENABLE);
1x0中：DMA_Init(DMA1_Channel3, &DMA_InitStructure); DMA_Cmd(DMA1_Channel3, ENABLE);
6、 RCC模块
系统时钟配置过程中，需要注意，GD32F1x0的APB1和APB2总线的最大时钟频率都是72MHz，而10x系列的APB1总线的最大时钟频率只有AHB的一半，APB2总线的最大时钟频率为AHB的时钟频率。这种区别反映在代码中如下：
10x系列，系统时钟配置文件（system_stm32f10x.c）中，SetSysClockTo72()函数里，PCLK1和PCLK2的配置代码如下： /* HCLK = SYSCLK */
RCC->CFGR |= (uint32_t)RCC_CFGR_HPRE_DIV1;
/* PCLK2 = HCLK */
RCC->CFGR |= (uint32_t)RCC_CFGR_PPRE2_DIV1; PCLK1只有36M /* PCLK1 = HCLK */ RCC->CFGR |= (uint32_t)RCC_CFGR_PPRE1_DIV2; 1x0系列相应位置配置为： /* HCLK = SYSCLK */
RCC->GCFGR |= (uint32_t)RCC_GCFGR_AHBPS_DIV1;
/* PCLK2 = HCLK */
RCC->GCFGR |= (uint32_t)RCC_GCFGR_APB2PS_DIV1; PCLK1=72M /* PCLK1 = HCLK */
RCC->GCFGR |= (uint32_t)RCC_GCFGR_APB1PS_DIV1;
在3205 A版的芯片中，USART1的波特率会受到PCLK1的影响，如果不把PCLK1改为HCLK不分频，会出现实际得到的串口波特率与预期不符，也即出现串口通讯乱码现象。
以上只是客户常用的模块的软件移植说明，可能还不够全面，欢迎大家积极补充。
