【国产MCU移植】手把手教你使用RT-Thread制作GD32系列BSP

本文由RT-Thread论坛用户@BruceOu原创发布：https://club.rt-thread.org/ask/article/3043.html

熟悉RT-Thread的朋友都知道，RT-Thread提供了许多BSP，但不是所有的板子都能找到相应的BSP，这时就需要移植新的BSP。RT-Thread的所有BSP中，最完善的BSP就是STM32系列，但从2020年下半年开始，国内出现史无前例的芯片缺货潮，芯片的交期和价格不断拉升，STM32的价格也是水涨船高，很多朋友也在考虑使用国产替代，笔者使用的兆易创新的GD32系列，我看了下RT-Thread中GD系列BSP，都是玩家各自为政，每个人都是提交自己使用的板子的BSP，充斥着大量冗余的代码，对于有强迫症的我就非常不爽，就根据手头的板子，参看STM32的BSP架构，构建了GD32的BSP架构。

笔者使用的开发板是兆易创新设计的GD32407V-START开发板。其主控芯片为GD32F407VKT6，主频168MHz，内部3072K Flash，192KB SRAM，资源相当丰富。

1 BSP 框架制作

在具体移植GD32407V-START的BSP之前，先做好GD32的BSP架构。BSP 框架结构如下图所示：

GD32的BSP架构主要分为三个部分：libraries、tools和具体的Boards，其中libraries包含了GD32的通用库，包括每个系列的HAL以及适配RT-Thread的drivers；tools是生成工程的Python脚本工具；另外就是Boards文件，当然这里的Boards有很多，我这里值列举了GD32407V-START。

这里先谈谈libraries和tools的构建，然后在后文单独讨论具体板级BSP的制作。

1.1 Libraries构建

Libraries文件夹包含兆易创新提供的HAL库，这个直接在兆易创新的官网就可以下载。

下载地址

然后将HAL库复制到libraries目录下，重命名为GD32F4xx_HAL，其他的系列类似。

GD32F4xx_HAL就是官方的文件，基本是不用动的，只是在文件夹中需要添加构建工程的脚本文件SConscript，其实也就是Python脚本。

SConscript文件的内容如下：

import rtconfig #导包
from building import *

# get current directory
cwd = GetCurrentDir() #获取当然路径

# The set of source files associated with this SConscript file.

src = Split('''
CMSIS/GD/GD32F4xx/Source/system_gd32f4xx.c
GD32F4xx_standard_peripheral/Source/gd32f4xx_gpio.c
GD32F4xx_standard_peripheral/Source/gd32f4xx_rcu.c
GD32F4xx_standard_peripheral/Source/gd32f4xx_exti.c
GD32F4xx_standard_peripheral/Source/gd32f4xx_misc.c
GD32F4xx_standard_peripheral/Source/gd32f4xx_syscfg.c
''')#将括号中的字符串分割后成列表(list)，以便包含到工程中
    
if GetDepend(['RT_USING_SERIAL']):#如果打开了RT_USING_SERIAL的宏，则会包含以下源文件
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_usart.c']
    
if GetDepend(['RT_USING_I2C']):
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_i2c.c']

if GetDepend(['RT_USING_SPI']):
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_spi.c']

if GetDepend(['RT_USING_CAN']):
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_can.c']

if GetDepend(['BSP_USING_ETH']):
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_enet.c']

if GetDepend(['RT_USING_ADC']):
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_adc.c']

if GetDepend(['RT_USING_DAC']):
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_dac.c']

if GetDepend(['RT_USING_RTC']):
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_rtc.c']

if GetDepend(['RT_USING_WDT']):
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_wwdgt.c']
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_fwdgt.c']

if GetDepend(['RT_USING_SDIO']):
    src += ['GD32F4xx_standard_peripheral/Source/gd32f4xx_sdio.c']

#头文件路径
path = [
    cwd + '/CMSIS/GD/GD32F4xx/Include',
    cwd + '/CMSIS',
    cwd + '/GD32F4xx_standard_peripheral/Include',]

CPPDEFINES = ['USE_STDPERIPH_DRIVER']
#定义一个组，组名为'Libraries', depend为空表示依赖任何一个其他宏，另外当前的头文件路径添加到工程中
group = DefineGroup('Libraries', src, depend = [''], CPPPATH = path, CPPDEFINES = CPPDEFINES)

Return('group')

该文件主要的作用就是添加库文件和头文件路径，一部分文件是属于基础文件，因此直接调用Python库的Split包含，另外一部分文件是根据实际的应用需求添加的。

这里是以GDF4来举例的，其他系列的都是类似的。

接下来说说Kconfig文件，这里是对内核和组件的功能进行配置，对RT-Thread的组件进行自由裁剪。
如果使用RT-Thread studio，则通过RT-Thread Setting可以体现Kconfig文件的作用。

如果使用ENV环境，则在使用 menuconfig配置和裁剪 RT-Thread时体现。

后面所有的Kconfig文件都是一样的逻辑。下表列举一些常用的Kconfig句法规则。

Kconfig的语法规则网上资料很多，自行去学习吧。

bsp/gd32/Kconfig内容如下：

config SOC_FAMILY_GD32
    bool

config SOC_SERIES_GD32F4
    bool
    select ARCH_ARM_CORTEX_M4
    select SOC_FAMILY_GD32

因为该架构目前笔者只移植了GDF4的，因此这里的内容比较少，如果有些的系列，直接参考F4的配置例子在这里加就可以了。

最后谈谈HAL_Drivers，这个文件夹就是GD32的外设驱动文件夹，为上层应用提供调用接口。

目前只有串口和GPIO的驱动，该文件夹是整个GD32共用的，因此在编写和修改都要慎重。关于drv_xxx文件在后句具体移植BSP的时候讲解，这里主要将整体架构，SConscript和Kconfig的作用和前面的一样，只是具体的内容不同罢了。

好了，先看bsp/gd32/HAL_Drivers/SConscript文件。

Import('RTT_ROOT')
Import('rtconfig')
from building import *

cwd = GetCurrentDir()#获取当前路径

# add the general drivers.
src = Split("""
""")#添加共同的驱动文件，暂无

# add pin drivers.
if GetDepend('RT_USING_PIN'):
    src += ['drv_gpio.c']
    
if GetDepend(['RT_USING_SERIAL']):
    src += ['drv_usart.c']

path =  [cwd]

group = DefineGroup('Drivers', src, depend = [''], CPPPATH = path)

Return('group')

和GD32F4xx_HAL文件夹中的SConscript是类似的。

bsp/gd32/HAL_Drivers/Kconfig文件结构如下：

if BSP_USING_USBD
    config BSP_USBD_TYPE_FS
        bool
        # "USB Full Speed (FS) Core"
    config BSP_USBD_TYPE_HS
        bool
        # "USB High Speed (HS) Core"

    config BSP_USBD_SPEED_HS
        bool 
        # "USB High Speed (HS) Mode"
    config BSP_USBD_SPEED_HSINFS
        bool 
        # "USB High Speed (HS) Core in FS mode"

    config BSP_USBD_PHY_EMBEDDED
        bool 
        # "Using Embedded phy interface"
    config BSP_USBD_PHY_UTMI
        bool 
        # "UTMI: USB 2.0 Transceiver Macrocell Interace"
    config BSP_USBD_PHY_ULPI
        bool 
        # "ULPI: UTMI+ Low Pin Interface"
endif

1.2 Tools构建

该文件夹就是工程构建的脚本，

import os
import sys
import shutil

cwd_path = os.getcwd()
sys.path.append(os.path.join(os.path.dirname(cwd_path), 'rt-thread', 'tools'))


# BSP dist function
def dist_do_building(BSP_ROOT, dist_dir):
    from mkdist import bsp_copy_files
    import rtconfig

    print("=> copy gd32 bsp library")
    library_dir = os.path.join(dist_dir, 'libraries')
    library_path = os.path.join(os.path.dirname(BSP_ROOT), 'libraries')
    bsp_copy_files(os.path.join(library_path, rtconfig.BSP_LIBRARY_TYPE),
                   os.path.join(library_dir, rtconfig.BSP_LIBRARY_TYPE))

    print("=> copy bsp drivers")
    bsp_copy_files(os.path