共计 21196 个字符，预计需要花费 53 分钟才能阅读完成。
本文由 RT-Thread 论坛用户 @爱玩的小赵 原创公布：https://club.rt-thread.org/as…
【国产 MCU 移植】手把手教你应用 RT-Thread 制作 GD32 系列 BSP
相熟 RT-Thread 的敌人都晓得，RT-Thread 提供了许多 BSP，但不是所有的板子都能找到相应的 BSP，这时就须要移植新的 BSP。RT-Thread 的所有 BSP 中，最欠缺的 BSP 就是 STM32 系列，但从 2020 年下半年开始，国内呈现前所未有的芯片缺货潮，咱们参考 STM32F103 系列进行 GD32F103 系列的 BSP 制作。
我应用的是 GD32F103VET6 芯片进行移植，在文章的开端附上自己 gitee 库。
**
1 BSP 框架制作
**
在具体移植 GD32407V-START 的 BSP 之前，先做好 GD32 的 BSP 架构。BSP 框架结构如下图所示：
在这里插入图片形容
GD32 的 BSP 架构次要分为三个局部：libraries、tools 和具体的 Boards，其中 libraries 蕴含了 GD32 的通用库，包含每个系列的 HAL 以及适配 RT-Thread 的 drivers；tools 是生成工程的 Python 脚本工具；另外就是 Boards 文件，当然这里的 Boards 有很多，我这里值列举了 GD32103C-eval。
这里先谈谈 libraries 和 tools 的构建，而后在后文独自探讨具体板级 BSP 的制作。
1.1 Libraries 构建
Libraries 文件夹蕴含兆易翻新提供的 HAL 库，这个间接在兆易翻新的官网就能够下载。
http://www.gd32mcu.com/cn/dow…
而后将 HAL 库（GD32F10x_Firmware_Library）复制到 libraries 目录下，重命名为 GD32F10x_Firmware_Library，其余的系列相似
GD32F10x_Firmware_Library 就是官网的文件，根本是不必动的，只是在文件夹中须要增加构建工程的脚本文件 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/GD32F10x/Source/system_gd32f10x.c
GD32F10x_standard_peripheral/Source/gd32f10x_gpio.c
GD32F10x_standard_peripheral/Source/gd32f10x_rcu.c
GD32F10x_standard_peripheral/Source/gd32f10x_exti.c
GD32F10x_standard_peripheral/Source/gd32f10x_misc.c
''')
if GetDepend(['RT_USING_SERIAL']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_usart.c']
if GetDepend(['RT_USING_I2C']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_i2c.c']
if GetDepend(['RT_USING_SPI']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_spi.c']
if GetDepend(['RT_USING_CAN']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_can.c']
if GetDepend(['BSP_USING_ETH']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_enet.c']
if GetDepend(['RT_USING_ADC']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_adc.c']
if GetDepend(['RT_USING_DAC']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_dac.c']
if GetDepend(['RT_USING_HWTIMER']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_timer.c']
if GetDepend(['RT_USING_RTC']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_rtc.c']
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_pmu.c']
if GetDepend(['RT_USING_WDT']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_wwdgt.c']
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_fwdgt.c']
if GetDepend(['RT_USING_SDIO']):
src += ['GD32F10x_standard_peripheral/Source/gd32f10x_sdio.c']
path = [
cwd + '/CMSIS/GD/GD32F10x/Include',
cwd + '/CMSIS',
cwd + '/GD32F10x_standard_peripheral/Include',]
CPPDEFINES = ['USE_STDPERIPH_DRIVER']
group = DefineGroup('Libraries', src, depend = [''], CPPPATH = path, CPPDEFINES = CPPDEFINES)
Return('group')
该文件次要的作用就是增加库文件和头文件门路，一部分文件是属于根底文件，因而间接调用 Python 库的 Split 蕴含，另外一部分文件是依据理论的利用需要增加的。
接下来说说 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_GD32F1
bool
select ARCH_ARM_CORTEX_M3
select SOC_FAMILY_GD32
config SOC_SERIES_GD32F2
bool
select ARCH_ARM_CORTEX_M3
select SOC_FAMILY_GD32
config SOC_SERIES_GD32F3
bool
select ARCH_ARM_CORTEX_M4
select SOC_FAMILY_GD32
config SOC_SERIES_GD32F4
bool
select ARCH_ARM_CORTEX_M4
select SOC_FAMILY_GD32
最初谈谈 HAL_Drivers，这个文件夹就是 GD32 的外设驱动文件夹，为下层利用提供调用接口。
好了，先看 E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\libraries\gd32_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']
# add usart drivers.
if GetDepend(['RT_USING_SERIAL']):
src += ['drv_usart.c']
# add i2c drivers.
if GetDepend(['RT_USING_I2C', 'RT_USING_I2C_BITOPS']):
if GetDepend('BSP_USING_I2C0') or GetDepend('BSP_USING_I2C1') or GetDepend('BSP_USING_I2C2') or GetDepend('BSP_USING_I2C3'):
src += ['drv_soft_i2c.c']
# add spi drivers.
if GetDepend('RT_USING_SPI'):
src += ['drv_spi.c']
# add spi flash drivers.
if GetDepend('RT_USING_SFUD'):
src += ['drv_spi_flash.c', 'drv_spi.c']
if GetDepend('RT_USING_WDT'):
src += ['drv_wdt.c']
if GetDepend('RT_USING_RTC'):
src += ['drv_rtc.c']
if GetDepend('RT_USING_HWTIMER'):
src += ['drv_hwtimer.c']
if GetDepend('RT_USING_ADC'):
src += ['drv_adc.c']
path = [cwd]
group = DefineGroup('Drivers', src, depend = [''], CPPPATH = path)
Return('group')
E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\libraries\gd32_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.join(library_path, 'HAL_Drivers'), os.path.join(library_dir, 'HAL_Drivers'))
shutil.copyfile(os.path.join(library_path, 'Kconfig'), os.path.join(library_dir, 'Kconfig'))以上代码很简略，次要应用了 Python 的 OS 模块的 join 函数，该函数的作用就是连贯两个或更多的路径名。最初将 BSP 依赖的文件复制到指定目录下。
在应用 scons –dist 命令打包的时候，就是依赖的该脚本，生成的 dist 文件夹的工程到任何目录下应用，也就是将 BSP 相干的库以及内核文件提取进去，能够将该工程任意拷贝。
1.3 gd32f103vet6-eval 构建
**
2 BSP 移植
**
2.1 Keil 环境筹备
接下来咱们下载 GD32F30x 的软件反对包。
下载地址：http://www.gd32mcu.com/cn/dow…
双击安装包，依照操作步骤进行装置。
装置胜利后，从新关上 Keil，则能够在 File->Device Database 中呈现 Gigadevice 的下拉选项，点击能够查看到相应的型号。
2.2 BSP 工程制作
1. 构建根底工程
首先看看 RT-Thread 代码仓库中已有很多 BSP，而我要移植的是 Cortex-M4 内核。这里我找了一个类似的内核，把它复制一份，并批改文件名为：gd32103C-eval。这样就有一个根底的工程。而后就开始增删改查，实现最终的 BSP，简直所有的 BSP 的制作都是如此。
2. 批改 BSP 构建脚本
E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6/Kconfig 批改后的内容如下
mainmenu "RT-Thread Configuration"
config BSP_DIR
string
option env="BSP_ROOT"
default "."
config RTT_DIR
string
option env="RTT_ROOT"
default "../../.."
config PKGS_DIR
string
option env="PKGS_ROOT"
default "packages"
source "$RTT_DIR/Kconfig"
source "$PKGS_DIR/Kconfig"
source "../libraries/Kconfig"
source "board/Kconfig"
该文件是获取所有门路下的 Kconfig。
E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6/SConscript 批改后的内容如下：
# for module compiling
import os
Import('RTT_ROOT')
from building import *
cwd = GetCurrentDir()
objs = []
list = os.listdir(cwd)
for d in list:
path = os.path.join(cwd, d)
if os.path.isfile(os.path.join(path, 'SConscript')):
objs = objs + SConscript(os.path.join(d, 'SConscript'))
Return('objs')
该文件是用于遍历当前目录的所有文件夹。
E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6/SConstruct 批改后的内容如下：
import os
import sys
import rtconfig
if os.getenv('RTT_ROOT'):
RTT_ROOT = os.getenv('RTT_ROOT')
else:
RTT_ROOT = os.path.normpath(os.getcwd() + '/../../..')
sys.path = sys.path + [os.path.join(RTT_ROOT, 'tools')]
try:
from building import *
except:
print('Cannot found RT-Thread root directory, please check RTT_ROOT')
print(RTT_ROOT)
exit(-1)
TARGET = 'rtthread.' + rtconfig.TARGET_EXT
DefaultEnvironment(tools=[])
env = Environment(tools = ['mingw'],
AS = rtconfig.AS, ASFLAGS = rtconfig.AFLAGS,
CC = rtconfig.CC, CCFLAGS = rtconfig.CFLAGS,
AR = rtconfig.AR, ARFLAGS = '-rc',
CXX = rtconfig.CXX, CXXFLAGS = rtconfig.CXXFLAGS,
LINK = rtconfig.LINK, LINKFLAGS = rtconfig.LFLAGS)
env.PrependENVPath('PATH', rtconfig.EXEC_PATH)
if rtconfig.PLATFORM == 'iar':
env.Replace(CCCOM = ['$CC $CCFLAGS $CPPFLAGS $_CPPDEFFLAGS $_CPPINCFLAGS -o $TARGET $SOURCES'])
env.Replace(ARFLAGS = [''])
env.Replace(LINKCOM = env["LINKCOM"] + '--map rtthread.map')
Export('RTT_ROOT')
Export('rtconfig')
SDK_ROOT = os.path.abspath('./')
if os.path.exists(SDK_ROOT + '/libraries'):
libraries_path_prefix = SDK_ROOT + '/libraries'
else:
libraries_path_prefix = os.path.dirname(SDK_ROOT) + '/libraries'
SDK_LIB = libraries_path_prefix
Export('SDK_LIB')
# prepare building environment
objs = PrepareBuilding(env, RTT_ROOT, has_libcpu=False)
gd32_library = 'GD32F10x_Firmware_Library'
rtconfig.BSP_LIBRARY_TYPE = gd32_library
# include libraries
objs.extend(SConscript(os.path.join(libraries_path_prefix, gd32_library, 'SConscript')))
# include drivers
objs.extend(SConscript(os.path.join(libraries_path_prefix, 'gd32_drivers', 'SConscript')))
# make a building
DoBuilding(TARGET, objs)
该文件用于链接所有的依赖文件，并调用 make 进行编译。
3. 批改开发环境信息
E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6/cconfig.h 批改后的内容如下
#ifndef CCONFIG_H__
#define CCONFIG_H__
/* Automatically generated file; DO NOT EDIT. */
/* compiler configure file for RT-Thread in GCC*/
#define HAVE_NEWLIB_H 1
#define LIBC_VERSION "newlib 2.4.0"
#define HAVE_SYS_SIGNAL_H 1
#define HAVE_SYS_SELECT_H 1
#define HAVE_PTHREAD_H 1
#define HAVE_FDSET 1
#define HAVE_SIGACTION 1
#define GCC_VERSION_STR "5.4.1 20160919 (release) [ARM/embedded-5-branch revision 240496]"
#define STDC "2011"
#endif
该文件是是编译 BSP 的环境信息，需依据实时批改。
4. 批改 KEIL 的模板工程
双击：template.uvprojx 即可批改模板工程。
批改为对应芯片设施:
批改 FLASH 和 RAM 的配置: 该局部需参照技术手册进行批改
批改可执行文件名字：
批改默认调试工具：CMSIS-DAP Debugger。
批改编程算法：
5. 批改 board 文件夹
(1) 批改 E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6\board\linker_scripts/link.icf
批改后的内容如下
/*###ICF### Section handled by ICF editor, don't touch! ****/
/*-Editor annotation file-*/
/* IcfEditorFile="$TOOLKIT_DIR$\config\ide\IcfEditor\cortex_v1_0.xml" */
/*-Specials-*/
define symbol __ICFEDIT_intvec_start__ = 0x08000000;
/*-Memory Regions-*/
define symbol __ICFEDIT_region_ROM_start__ = 0x08000000;
define symbol __ICFEDIT_region_ROM_end__ = 0x08080000;
define symbol __ICFEDIT_region_RAM_start__ = 0x20000000;
define symbol __ICFEDIT_region_RAM_end__ = 0x20010000;
/*-Sizes-*/
define symbol __ICFEDIT_size_cstack__ = 0x200;
define symbol __ICFEDIT_size_heap__ = 0x200;
/**** End of ICF editor section. ###ICF###*/
export symbol __ICFEDIT_region_RAM_end__;
define symbol __region_RAM1_start__ = 0x10000000;
define symbol __region_RAM1_end__ = 0x1000FFFF;
define memory mem with size = 4G;
define region ROM_region = mem:[from __ICFEDIT_region_ROM_start__ to __ICFEDIT_region_ROM_end__];
define region RAM_region = mem:[from __ICFEDIT_region_RAM_start__ to __ICFEDIT_region_RAM_end__];
define region RAM1_region = mem:[from __region_RAM1_start__ to __region_RAM1_end__];
define block CSTACK with alignment = 8, size = __ICFEDIT_size_cstack__ { };
define block HEAP with alignment = 8, size = __ICFEDIT_size_heap__ { };
initialize by copy {readwrite};
do not initialize {section .noinit};
keep {section FSymTab};
keep {section VSymTab};
keep {section .rti_fn*};
place at address mem:__ICFEDIT_intvec_start__ {readonly section .intvec};
place in ROM_region {readonly};
place in RAM_region { readwrite,
block CSTACK, block HEAP };
place in RAM1_region {section .sram};该文件是 IAR 编译的链接脚本，依据《GD32F103xx_Datasheet_Rev2.1》可知，GD32F103VET6 的 flash 大小为 3072KB，SRAM 大小为 192KB，因而须要设置 ROM 和 RAM 的起始地址和堆栈大小等。
(2) 批改 E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6\board\linker_scripts/link.ld
批改后的内容如下：
/*
* linker script for GD32F30x with GNU ld
* BruceOu 2021-12-18
*/
/* Program Entry, set to mark it as "used" and avoid gc */
MEMORY
{CODE (rx) : ORIGIN = 0x08000000, LENGTH = 512k /* 256KB flash */
DATA (rw) : ORIGIN = 0x20000000, LENGTH = 64k /* 48KB sram */
}
ENTRY(Reset_Handler)
_system_stack_size = 0x200;
SECTIONS
{
.text :
{. = ALIGN(4);
_stext = .;
KEEP(*(.isr_vector)) /* Startup code */
. = ALIGN(4);
*(.text) /* remaining code */
*(.text.*) /* remaining code */
*(.rodata) /* read-only data (constants) */
*(.rodata*)
*(.glue_7)
*(.glue_7t)
*(.gnu.linkonce.t*)
/* section information for finsh shell */
. = ALIGN(4);
__fsymtab_start = .;
KEEP(*(FSymTab))
__fsymtab_end = .;
. = ALIGN(4);
__vsymtab_start = .;
KEEP(*(VSymTab))
__vsymtab_end = .;
. = ALIGN(4);
/* section information for initial. */
. = ALIGN(4);
__rt_init_start = .;
KEEP(*(SORT(.rti_fn*)))
__rt_init_end = .;
. = ALIGN(4);
. = ALIGN(4);
_etext = .;
} > CODE = 0
/* .ARM.exidx is sorted, so has to go in its own output section. */
__exidx_start = .;
.ARM.exidx :
{*(.ARM.exidx* .gnu.linkonce.armexidx.*)
/* This is used by the startup in order to initialize the .data secion */
_sidata = .;
} > CODE
__exidx_end = .;
/* .data section which is used for initialized data */
.data : AT (_sidata)
{. = ALIGN(4);
/* This is used by the startup in order to initialize the .data secion */
_sdata = . ;
*(.data)
*(.data.*)
*(.gnu.linkonce.d*)
. = ALIGN(4);
/* This is used by the startup in order to initialize the .data secion */
_edata = . ;
} >DATA
.stack :
{
. = . + _system_stack_size;
. = ALIGN(4);
_estack = .;
} >DATA
__bss_start = .;
.bss :
{. = ALIGN(4);
/* This is used by the startup in order to initialize the .bss secion */
_sbss = .;
*(.bss)
*(.bss.*)
*(COMMON)
. = ALIGN(4);
/* This is used by the startup in order to initialize the .bss secion */
_ebss = . ;
*(.bss.init)
} > DATA
__bss_end = .;
_end = .;
/* Stabs debugging sections. */
.stab 0 : {*(.stab) }
.stabstr 0 : {*(.stabstr) }
.stab.excl 0 : {*(.stab.excl) }
.stab.exclstr 0 : {*(.stab.exclstr) }
.stab.index 0 : {*(.stab.index) }
.stab.indexstr 0 : {*(.stab.indexstr) }
.comment 0 : {*(.comment) }
/* DWARF debug sections.
* Symbols in the DWARF debugging sections are relative to the beginning
* of the section so we begin them at 0. */
/* DWARF 1 */
.debug 0 : {*(.debug) }
.line 0 : {*(.line) }
/* GNU DWARF 1 extensions */
.debug_srcinfo 0 : {*(.debug_srcinfo) }
.debug_sfnames 0 : {*(.debug_sfnames) }
/* DWARF 1.1 and DWARF 2 */
.debug_aranges 0 : {*(.debug_aranges) }
.debug_pubnames 0 : {*(.debug_pubnames) }
/* DWARF 2 */
.debug_info 0 : {*(.debug_info .gnu.linkonce.wi.*) }
.debug_abbrev 0 : {*(.debug_abbrev) }
.debug_line 0 : {*(.debug_line) }
.debug_frame 0 : {*(.debug_frame) }
.debug_str 0 : {*(.debug_str) }
.debug_loc 0 : {*(.debug_loc) }
.debug_macinfo 0 : {*(.debug_macinfo) }
/* SGI/MIPS DWARF 2 extensions */
.debug_weaknames 0 : {*(.debug_weaknames) }
.debug_funcnames 0 : {*(.debug_funcnames) }
.debug_typenames 0 : {*(.debug_typenames) }
.debug_varnames 0 : {*(.debug_varnames) }
}
该文件是 GCC 编译的链接脚本，依据《GD32F407xx_Datasheet_Rev2.1》可知，GD32F407VKT6 的 flash 大小为 3072KB，SRAM 大小为 192KB，因而 CODE 和 DATA 的 LENGTH 别离设置为 3072KB 和 192KB，其余芯片相似，但其实地址都是一样的。
(3) 批改 E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6\board/linker_scripts/link.sct
该文件是 MDK 的连贯脚本，依据《GD32F407xx_Datasheet_Rev2.1》手册，因而须要将 LR_IROM1 和 ER_IROM1 的参数设置为 0x00300000；RAM 的大小为 192k，因而须要将 RW_IRAM1 的参数设置为 0x00030000。
; *************************************************************
; *** Scatter-Loading Description File generated by uVision ***
; *************************************************************
LR_IROM1 0x08000000 0x00080000 { ; load region size_region
ER_IROM1 0x08000000 0x00080000 { ; load address = execution address
*.o (RESET, +First)
*(InRoot$$Sections)
.ANY (+RO)
}
RW_IRAM1 0x20000000 0x00010000 { ; RW data
.ANY (+RW +ZI)
}
}
(4) 批改 E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6\board/board.h 文件
批改后内容如下：
/*
* Copyright (c) 2006-2021, RT-Thread Development Team
*
* SPDX-License-Identifier: Apache-2.0
*
* Change Logs:
* Date Author Notes
* 2021-12-18 BruceOu first implementation
*/
#ifndef __BOARD_H__
#define __BOARD_H__
#include "gd32f10x.h"
#include "drv_usart.h"
#include "drv_gpio.h"
#include "gd32f10x_exti.h"
#define EXT_SDRAM_BEGIN (0xC0000000U) /* the begining address of external SDRAM */
#define EXT_SDRAM_END (EXT_SDRAM_BEGIN + (32U * 1024 * 1024)) /* the end address of external SDRAM */
// <o> Internal SRAM memory size[Kbytes] <8-48>
// <i>Default: 48
#ifdef __ICCARM__
// Use *.icf ram symbal, to avoid hardcode.
extern char __ICFEDIT_region_RAM_end__;
#define GD32_SRAM_END &__ICFEDIT_region_RAM_end__
#else
#define GD32_SRAM_SIZE 64
#define GD32_SRAM_END (0x20000000 + GD32_SRAM_SIZE * 1024)
#endif
#ifdef __CC_ARM
extern int Image$$RW_IRAM1$$ZI$$Limit;
#define HEAP_BEGIN (&Image$$RW_IRAM1$$ZI$$Limit)
#elif __ICCARM__
#pragma section="HEAP"
#define HEAP_BEGIN (__segment_end("HEAP"))
#else
extern int __bss_end;
#define HEAP_BEGIN (&__bss_end)
#endif
#define HEAP_END GD32_SRAM_END
#endif
值得注意的是，不同的编译器规定的堆栈内存的起始地址 HEAP_BEGIN 和完结地址 HEAP_END。这里 HEAP_BEGIN 和 HEAP_END 的值须要和后面的链接脚本是统一的，须要结合实际去批改。
(5) 批改 E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6\board/board.c 文件
批改后的文件如下：
/*
* Copyright (c) 2006-2021, RT-Thread Development Team
*
* SPDX-License-Identifier: Apache-2.0
*
* Change Logs:
* Date Author Notes
* 2021-12-18 BruceOu first implementation
*/
#include <stdint.h>
#include <rthw.h>
#include <rtthread.h>
#include <board.h>
/**
* @brief This function is executed in case of error occurrence.
* @param None
* @retval None
*/
void Error_Handler(void)
{
/* USER CODE BEGIN Error_Handler */
/* User can add his own implementation to report the HAL error return state */
while (1)
{ }
/* USER CODE END Error_Handler */
}
/** System Clock Configuration
*/
void SystemClock_Config(void)
{SysTick_Config(SystemCoreClock / RT_TICK_PER_SECOND);
NVIC_SetPriority(SysTick_IRQn, 0);
}
/**
* This is the timer interrupt service routine.
*
*/
void SysTick_Handler(void)
{
/* enter interrupt */
rt_interrupt_enter();
rt_tick_increase();
/* leave interrupt */
rt_interrupt_leave();}
/**
* This function will initial GD32 board.
*/
void rt_hw_board_init()
{
/* NVIC Configuration */
#define NVIC_VTOR_MASK 0x3FFFFF80
#ifdef VECT_TAB_RAM
/* Set the Vector Table base location at 0x10000000 */
SCB->VTOR = (0x10000000 & NVIC_VTOR_MASK);
#else /* VECT_TAB_FLASH */
/* Set the Vector Table base location at 0x08000000 */
SCB->VTOR = (0x08000000 & NVIC_VTOR_MASK);
#endif
SystemClock_Config();
#ifdef RT_USING_COMPONENTS_INIT
rt_components_board_init();
#endif
#ifdef RT_USING_CONSOLE
rt_console_set_device(RT_CONSOLE_DEVICE_NAME);
#endif
#ifdef BSP_USING_SDRAM
rt_system_heap_init((void *)EXT_SDRAM_BEGIN, (void *)EXT_SDRAM_END);
#else
rt_system_heap_init((void *)HEAP_BEGIN, (void *)HEAP_END);
#endif
}
/*@}*/
该文件重点关注的就是 SystemClock_Config 配置，SystemCoreClock 的定义在 system_gd32f1xx.c 中定义的.
(6) 批改 E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6\board/Kconfig 文件
批改后内容如下：
menu "Hardware Drivers Config"
config SOC_SERIES_GD32F10x
bool
default y
config SOC_GD32103V
bool
select SOC_SERIES_GD32F10x
select RT_USING_COMPONENTS_INIT
select RT_USING_USER_MAIN
default y
menu "Onboard Peripheral Drivers"
endmenu
menu "On-chip Peripheral Drivers"
config BSP_USING_GPIO
bool "Enable GPIO"
select RT_USING_PIN
default y
menuconfig BSP_USING_UART
bool "Enable UART"
default y
select RT_USING_SERIAL
if BSP_USING_UART
config BSP_USING_UART0
bool "Enable UART0"
default n
config BSP_UART0_RX_USING_DMA
bool "Enable UART0 RX DMA"
depends on BSP_USING_UART0
select RT_SERIAL_USING_DMA
default n
config BSP_USING_UART1
bool "Enable UART1"
default y
config BSP_UART1_RX_USING_DMA
bool "Enable UART1 RX DMA"
depends on BSP_USING_UART1
select RT_SERIAL_USING_DMA
default n
config BSP_USING_UART2
bool "Enable UART2"
default n
config BSP_UART2_RX_USING_DMA
bool "Enable UART2 RX DMA"
depends on BSP_USING_UART2
select RT_SERIAL_USING_DMA
default n
config BSP_USING_UART3
bool "Enable UART3"
default n
config BSP_UART3_RX_USING_DMA
bool "Enable UART3 RX DMA"
depends on BSP_USING_UART3
select RT_SERIAL_USING_DMA
default n
config BSP_USING_UART4
bool "Enable UART4"
default n
config BSP_UART4_RX_USING_DMA
bool "Enable UART4 RX DMA"
depends on BSP_USING_UART4
select RT_SERIAL_USING_DMA
default n
endif
menuconfig BSP_USING_SPI
bool "Enable SPI BUS"
default n
select RT_USING_SPI
if BSP_USING_SPI
config BSP_USING_SPI1
bool "Enable SPI1 BUS"
default n
config BSP_SPI1_TX_USING_DMA
bool "Enable SPI1 TX DMA"
depends on BSP_USING_SPI1
default n
config BSP_SPI1_RX_USING_DMA
bool "Enable SPI1 RX DMA"
depends on BSP_USING_SPI1
select BSP_SPI1_TX_USING_DMA
default n
endif
menuconfig BSP_USING_I2C1
bool "Enable I2C1 BUS (software simulation)"
default n
select RT_USING_I2C
select RT_USING_I2C_BITOPS
select RT_USING_PIN
if BSP_USING_I2C1
config BSP_I2C1_SCL_PIN
int "i2c1 scl pin number"
range 1 216
default 24
config BSP_I2C1_SDA_PIN
int "I2C1 sda pin number"
range 1 216
default 25
endif
config BSP_USING_WDT
bool "Enable Watchdog Timer"
select RT_USING_WDT
default n
config BSP_USING_RTC
bool "Enable Internal RTC"
select RT_USING_RTC
default n
menuconfig BSP_USING_HWTIMER
bool "Enable hwtimer"
default n
select RT_USING_HWTIMER
if BSP_USING_HWTIMER
config BSP_USING_HWTIMER0
bool "using hwtimer0"
default n
config BSP_USING_HWTIMER1
bool "using hwtimer1"
default n
config BSP_USING_HWTIMER2
bool "using hwtimer2"
default n
config BSP_USING_HWTIMER3
bool "using hwtimer3"
default n
config BSP_USING_HWTIMER4
bool "using hwtimer4"
default n
config BSP_USING_HWTIMER5
bool "using hwtimer5"
default n
config BSP_USING_HWTIMER6
bool "using hwtimer6"
default n
config BSP_USING_HWTIMER7
bool "using hwtimer7"
default n
endif
menuconfig BSP_USING_ADC
bool "Enable ADC"
default n
select RT_USING_ADC
if BSP_USING_ADC
config BSP_USING_ADC0
bool "using adc0"
default n
config BSP_USING_ADC1
bool "using adc1"
default n
endif
source "../libraries/gd32_drivers/Kconfig"
endmenu
menu "Board extended module Drivers"
endmenu
endmenu
这个文件就是配置板子驱动的，这里可依据理论需要增加。
(7) 批改 E:\RT_Thread\GD32_BSP\rt_thread_code\bsp\gd32f103\gd32f103vet6\board/SConscript 文件
批改后内容如下：
import os
import rtconfig
from building import *
Import('SDK_LIB')
cwd = GetCurrentDir()
# add general drivers
src = Split('''board.c''')
path = [cwd]
startup_path_prefix = SDK_LIB
if rtconfig.PLATFORM == 'gcc':
src += [startup_path_prefix + '/GD32F10x_Firmware_Library/CMSIS/GD/GD32F10x/Source/GCC/startup_gd32f10x_hd.s']
elif rtconfig.PLATFORM in ['armcc', 'armclang']:
src += [startup_path_prefix + '/GD32F10x_Firmware_Library/CMSIS/GD/GD32F10x/Source/ARM/startup_gd32f10x_hd.s']
elif rtconfig.CROSS_TOOL == 'iar':
src += [startup_path_prefix + '/GD32F10x_Firmware_Library/CMSIS/GD/GD32F10x/Source/IAR/startup_gd32f10x_hd.s']
CPPDEFINES = ['GD32F10X_HD']
group = DefineGroup('Drivers', src, depend = [''], CPPPATH = path, CPPDEFINES = CPPDEFINES)
Return('group')
cwd = GetCurrentDir()
# add general drivers
src = Split('''board.c''')
path = [cwd]
startup_path_prefix = SDK_LIB
if rtconfig.CROSS_TOOL == 'gcc':
src += [startup_path_prefix + '/GD32F4xx_HAL/CMSIS/GD/GD32F4xx/Source/GCC/startup_gd32f4xx.S']
elif rtconfig.CROSS_TOOL == 'keil':
src += [startup_path_prefix + '/GD32F4xx_HAL/CMSIS/GD/GD32F4xx/Source/ARM/startup_gd32f4xx.s']
elif rtconfig.CROSS_TOOL == 'iar':
src += [startup_path_prefix + '/GD32F4xx_HAL/CMSIS/GD/GD32F4xx/Source/IAR/startup_gd32f4xx.s']
CPPDEFINES = ['GD32F407xx']
group = DefineGroup('Drivers', src, depend = [''], CPPPATH = path, CPPDEFINES = CPPDEFINES)
Return('group')该文件次要增加 board 文件夹的.c 文件和头文件门路。另外依据开发环境抉择相应的汇编文件，和后面的 libraries 的 SConscript 语法是一样，文件的构造都是相似的，这里就没有正文了。
到这里，根本所有的依赖脚本都配置实现了，接下来将通过 menuconfig 配置工程。
6.menuconfig 配置
** 剩下的笔者参考：https://club.rt-thread.org/as…
同时文章构造也采纳 ·BruceOu 博主的文章构造，在这里对原文章博主表示感谢。**
对 @乐乐爱学习 学长表示感谢，哈哈哈，学长的话如同涛涛江水，川流不息。一位优良的全栈工程师 @乐乐爱学习
Gitee:https://gitee.com/zhaodhajhdj…
正文完