无刷电机小车开发记录01——制作RTT内GD32E503器件的BSP

RTThread物联网操作系统 2023-08-31 922

描述

前情提要

最近计划开始做一个无刷电机的小车玩玩，不用网上的现有方案，一切从零开始自己做方案。硬件方案打算用GD32E503和EG2134栅极驱动IC等一系列国产器件去做，这样就面临一个问题，不太好用Arduino跑SimpleFOC快速出原型。所以软件方案想基于RTT开发，这样只需移植一些硬件驱动和FOC以及卡尔曼滤波等算法，其它的很多功能还是可以用RThread组件实现的，总不能所有轮子都自己造，毕竟玩这个小车的目的也只是想深入玩玩这些控制算法。这个小车的整个开发周期可能会很长，至少是以年为度量单位的，第一是因为工作比较忙，只能用一些零散时间搞，第二是因为计划用到什么学什么，有意思的地方都深入的研究研究，不以速成为目的。整个开发过程也都记录一下，图文形式的记录可能会在RTThread论坛进行记录，视频形式的记录就发布在B站上，希望有兴趣的小伙伴也可以一起玩一玩哈。

前期工作

前段时间，大概花了一周的时间已经把第一版测试用的硬件电路和机械结构设计完毕，如下是硬件电路的3D视图。

RT-Thread

如下是三轮小车形态的车底盘3D渲染图：

RT-Thread

下图是平衡车形态的车底盘3D渲染图：

RT-Thread

下图为二阶平衡车形态的车底盘3D渲染图：

RT-Thread

目前第一版的硬件测试电路已焊接完毕，第一版测试小车也完成了组装，下图是刚组装起来的平衡车形态的无刷电机小车，就计划先拿它开刀了，其它形态后面再慢慢玩。小车还算小巧，等测试通过后计划再做一版集成度更高更小巧的玩玩。

RT-Thread

千里之行始于创建BSP

一切就绪，准备开始撸程序了，那遇到的第一个问题就是目前RTThread的BSP内并没有我想用的这款GD32E503的处理器（用这款处理器是想玩一玩它的三角函数加速器，有硬件计算电路，就不用查询法去计算三角函数了，感觉跑FOC会舒服很多）。所以第一步就是要学习一下添加自己的BSP了。

下载GD32E503固件库和RTT源码包

做BSP的第一步，自然是下载RTThread源码和GD32E503的固件库了。目前RTThread的稳定发行版应该是4.1.0，但我这里只是玩玩，对稳定度要求不高，果断去码云上下载了最新的master版本，目前的版本是5.0.1：

RT-Thread

1/* RT-Thread version information */ 2#define RT_VERSION_MAJOR 5 /**< Major version number (X.x.x) */ 3#define RT_VERSION_MINOR 0 /**< Minor version number (x.X.x) */ 4#define RT_VERSION_PATCH 1 /**< Patch version number (x.x.X) */

GD32E503的固件库包含在开发板Demo资料里，最新版本是V1.2.2：

RT-Thread

添加GD32E503器件到MDK

GD32E50x的AddOn资源包，目前最新版本是1.3.3，如果还没有安装MDK需要先安装一下MDK，这里不做过多表述，然后再安装AddOn资源包内的两个”.pack”文件(也可以只安装E50x版本的)：

RT-Thread

如下图所示，MDK内的DeviceDatabase内能找到GD32E50x系列的器件列表，证明资源包安装成功。

RT-Thread

添加libraries

拷贝固件库到BSP的libraries目录内

解压RTT源码包和固件库压缩包，先拷贝固件库的”GD32E50x_Firmware_Library”文件夹到RTT源码包的”bsp/gd32/arm/libraries/“路径下：

RT-Thread

修改libraries目录内的配置文件

这里可以看到libraries目录下还有两个配置文件“Kconfig”和“.ignore_format.yml”，Kconfig文件后面用menuconfig或RTthreadStudio IDE去配置肯定会用到，另外一个文件暂时不知道什么用途，但不妨一起修改了，Kconfig文件修改如下(文档末尾添加GD32E5的配置信息)：

1config SOC_FAMILY_GD32 2 bool 3config SOC_SERIES_GD32F1 4 bool 5 select ARCH_ARM_CORTEX_M3 6 select SOC_FAMILY_GD32 7config SOC_SERIES_GD32F2 8 bool 9 select ARCH_ARM_CORTEX_M3 10 select SOC_FAMILY_GD32 11config SOC_SERIES_GD32F3 12 bool 13 select ARCH_ARM_CORTEX_M4 14 select SOC_FAMILY_GD32 15config SOC_SERIES_GD32F4 16 bool 17 select ARCH_ARM_CORTEX_M4 18 select SOC_FAMILY_GD32 19config SOC_SERIES_GD32E5 #add by cjl 20 bool 21 select ARCH_ARM_CORTEX_M33 22 select SOC_FAMILY_GD32

“.yml”文件把GD32E50x的固件库路径名添加到数组末尾：

1dir_path: 2- GD32F10x_Firmware_Library 3- GD32F20x_Firmware_Library 4- GD32F30x_Firmware_Library 5- GD32F4xx_Firmware_Library 6- GD32E50x_Firmware_Library

给固件库添加SConscript构建配置文件

从其它固件库文件内(我用的F4xx)拷贝一份”SConscript”文件到新加入的固件库路径内：

RT-Thread

1import rtconfig 2from building import * 3# get current directory 4cwd = GetCurrentDir() 5# The set of source files associated with this SConscript file. 6src = Split(''' 7CMSIS/GD/GD32E50x/Source/system_gd32e50x.c 8GD32E50x_standard_peripheral/Source/gd32e50x_gpio.c 9GD32E50x_standard_peripheral/Source/gd32e50x_rcu.c 10GD32E50x_standard_peripheral/Source/gd32e50x_exti.c 11GD32E50x_standard_peripheral/Source/gd32e50x_misc.c 12''') 13# remove: GD32E50x_standard_peripheral/Source/gd32e50x_syscfg.c 14if GetDepend(['RT_USING_SERIAL']): 15 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_usart.c'] 16if GetDepend(['RT_USING_I2C']): 17 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_i2c.c'] 18if GetDepend(['RT_USING_SPI']): 19 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_spi.c'] 20if GetDepend(['RT_USING_CAN']): 21 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_can.c'] 22if GetDepend(['BSP_USING_ETH']): 23 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_enet.c'] 24if GetDepend(['RT_USING_ADC']): 25 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_adc.c'] 26if GetDepend(['RT_USING_DAC']): 27 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_dac.c'] 28if GetDepend(['RT_USING_RTC']): 29 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_rtc.c'] 30 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_pmu.c'] 31if GetDepend(['RT_USING_WDT']): 32 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_wwdgt.c'] 33 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_fwdgt.c'] 34if GetDepend(['RT_USING_SDIO']): 35 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_sdio.c'] 36 src += ['GD32E50x_standard_peripheral/Source/gd32e50x_dma.c'] 37path = [ 38 cwd + '/CMSIS/GD/GD32E50x/Include', 39 cwd + '/CMSIS', 40 cwd + '/GD32E50x_standard_peripheral/Include',] 41CPPDEFINES = ['USE_STDPERIPH_DRIVER'] 42group = DefineGroup('Libraries', src, depend = [''], CPPPATH = path, CPPDEFINES = CPPDEFINES) 43Return('group')

创建BSP

拷贝BSP模板

任意拷贝一份BSP文件夹（我同样也是用的407）重命名为E503:

RT-Thread

修改board.h头文件

其中主要需要修改的内容都在board路径下。先看board.h文件，我这里没有做外部SDRAM，所以注释掉相关定义，我板子实际焊的是GD32E503RCT6，所以SRAM大小改为96KB，再把相关头文件名修改一下：

1#ifndef __BOARD_H__ 2#define __BOARD_H__ 3#include "gd32e50x.h" 4#include "drv_usart.h" 5#include "drv_gpio.h" 6#include "gd32e50x_exti.h" 7//#define EXT_SDRAM_BEGIN (0xC0000000U) /* the begining address of external SDRAM */ 8//#define EXT_SDRAM_END (EXT_SDRAM_BEGIN + (32U * 1024 * 1024)) /* the end address of external SDRAM */ 9// Internal SRAM memory size[Kbytes] <8-64> 10// Default: 64 11#ifdef __ICCARM__ 12// Use *.icf ram symbal, to avoid hardcode. 13extern char __ICFEDIT_region_RAM_end__; 14#define GD32_SRAM_END &__ICFEDIT_region_RAM_end__ 15#else 16#define GD32_SRAM_SIZE 96 //96 for GD32E503xC 128 for GD32E503xE ... 17#define GD32_SRAM_END (0x20000000 + GD32_SRAM_SIZE * 1024) 18#endif 19#ifdef __ARMCC_VERSION 20extern int Image$$RW_IRAM1$$ZI$$Limit; 21#define HEAP_BEGIN (&Image$$RW_IRAM1$$ZI$$Limit) 22#elif __ICCARM__ 23#pragma section="HEAP" 24#define HEAP_BEGIN (__segment_end("HEAP")) 25#else 26extern int __bss_end; 27#define HEAP_BEGIN (&__bss_end) 28#endif 29#define HEAP_END GD32_SRAM_END 30#endif

添加gd32e50x_libopt.h

在固件库内的随便一个例程路径内拷贝一份”gd32e50x_libopt.h”到当前bsp的board路径内，替换掉原有的“gd32f4xx_libopt.h”

修改board目录下的Kconfig和SConscript配置文件

而对于board目录下的“Kconfig”和“SConscript”配置文件也要稍作修改，基本都是把F4xx的字符串改成E50x的。稍需注意的是“SConscript”文件内对于启动文件相关的配置，E50x有高密度（hd）和互联（cl）两个版本。我这里用的E503RC或者是RE都是高密度版本，所以选择hd的汇编启动文件。而且还需要说明的是，虽然我这里没有注释掉gcc编译器下的启动文件，但其实E503的固件库内并没有提供gcc版本的启动文件，也就是说后面不能用RTT的IDE去开发了。等什么时候有了再加进来吧。或者后面看需要，不行就自己改一版gcc编译器的启动文件。目前这两个文件就暂且修改这么多，后面再看情况，如有问题再进行修改。

“SConscript”文件修改如下：

1import os 2import rtconfig 3from building import * 4Import('SDK_LIB') 5cwd = GetCurrentDir() 6# add general drivers 7src = Split(''' 8board.c 9''') 10path =  [cwd] 11startup_path_prefix = SDK_LIB 12if rtconfig.PLATFORM in ['gcc']: 13    src += [startup_path_prefix + '/GD32E50x_Firmware_Library/CMSIS/GD/GD32E50x/Source/GCC/startup_gd32e50x_hd.s'] 14elif rtconfig.PLATFORM in ['armcc', 'armclang']: 15    src += [startup_path_prefix + '/GD32E50x_Firmware_Library/CMSIS/GD/GD32E50x/Source/ARM/startup_gd32e50x_hd.s'] 16elif rtconfig.PLATFORM in ['iccarm']: 17    src += [startup_path_prefix + '/GD32E50x_Firmware_Library/CMSIS/GD/GD32E50x/Source/IAR/startup_gd32e50x_hd.s'] 18CPPDEFINES = ['GD32E50X','GD32E50X_HD'] 19group = DefineGroup('Drivers', src, depend = [''], CPPPATH = path, CPPDEFINES = CPPDEFINES) 20Return('group')

修改三种编译器用的链接脚本

修改”board/linker_scripts”目录下的连接文件，如无特殊要求可不对连接脚本做太多修改，只需要修改RAM和ROM地址和大小即可，以“link.sct”为例：

1LR_IROM1 0x08000000 0x00040000  {    ; load region size_region  256KB 2  ER_IROM1 0x08000000 0x00040000  {  ; load address = execution address 3   *.o (RESET, +First) 4   *(InRoot$$Sections) 5   .ANY (+RO) 6  } 7  RW_IRAM1 0x20000000 0x00018000  {  ; RW data  96KB 8   .ANY (+RW +ZI) 9  } 10}

修改BSP顶层SConstruct和rtconfig.py文件

修改新建bsp目录下的SConstruct文件和rtconfig.py文件：

SConstruct文件只需要修改“gd32_library”的值：

1gd32_library = 'GD32E50x_Firmware_Library'

修改工程模板

接下来修改工程模板文件，我这边只修改MDK5版本的工程模板：

修改Device为实际使用的GD32E503RC:

调试工具改成DAP：

利用env工具配置RTthread并生成MDK工程

在新键的bsp目录下运行env工具（env工具的安装与使用请参考RTT官方文档），对RTT做初步配置：

最后根据提示，输入命令生成mdk5的工程，（如果想要提交自己制作的BSP，请参照官方BSP制作规范）:

下载验证

最后打开工程，稍微修改一下main.c内的内容，加一条调试语句，修改对应的LED引脚。编译一下，如果能编译通过说明上面修改的内容没问题，如果有错误请仔细检查上面格配置文件修改的内容是否正确或者自行根据错误提示进行修改。烧录程序就可以看到运行效果了。

1#include 2#include 3#include 4#include 5/* defined the LED2 pin: PC6 */ 6#define LED_PIN GET_PIN(B, 11) 7#define BUZZER_PIN GET_PIN(B, 12) 8int main(void) 9{ 10    int count = 1; 11    /* set LED2 pin mode to output */ 12    rt_pin_mode(LED_PIN, PIN_MODE_OUTPUT); 13    rt_pin_write(BUZZER_PIN, PIN_LOW); 14    rt_pin_mode(BUZZER_PIN, PIN_MODE_OUTPUT); 15    rt_kprintf("无刷电机小车测试程序! "); 16    while (count++) 17    { 18        rt_pin_write(LED_PIN, PIN_HIGH); 19        rt_thread_mdelay(500); 20        rt_pin_write(LED_PIN, PIN_LOW); 21        rt_thread_mdelay(500); 22    } 23    return RT_EOK; 24}

今天就先玩到这里，后面再使用一段时间这个BSP，需要优化的地方优化一下，然后再往码云上提交一份。

其它链接

视频方面目前只有一个前期的开题视频，简单讲了一下想做一些什么，过了一遍硬件电路的设计方案，想了解详情的可以观看下面的视频哦！更多的阶段性功能展示以及调试视频后续再慢慢更新。

【无刷电机小车——搞起来！-哔哩哔哩】 https://b23.tv/ZmvhBS7

无刷电机小车开发记录02——BSP导入RTThreadStudio：https://club.rt-thread.org/ask/article/4c90d45831ce0722.html

无刷电机小车开发记录03——PWM信号输入捕获驱动：https://club.rt-thread.org/ask/article/dc39eb608f1eba75.html

无刷电机小车开发记录04——互补PWM驱动移植：https://club.rt-thread.org/ask/article/004229252f06d18d.html

———————End———————

点击阅读原文进入官网

原文标题：无刷电机小车开发记录01——制作RTT内GD32E503器件的BSP

文章出处：【微信公众号：RTThread物联网操作系统】欢迎添加关注！文章转载请注明出处。

打开APP阅读更多精彩内容