兆易创新GD32VW553上的UART实践 | 技术集结-电子发烧友网

《兆易创新 GD32VW553H-EVAL开发实践指南》电子书正式上线！本书是RT-Thread 工程师团队与兆易创新联合推出的评测活动产出，系统梳理了从UART、WDG、I2C、TIMER、PWM、SPI等基础外设，到Wi-Fi 无线通信的完整驱动开发实践，手把手带你完成从硬件调试到无线应用部署的完整流程。

本文是《GD32VW553上的UART实践》。

开发环境搭建

VSCode软件调试环境搭建

芯片资源 - Uart

UART功能调试

Git链接

开发者贡献名单

1 开发环境搭建

1.1 软件下载链接

RT-Thread 环境：https://github.com/RT-Thread/rt-thread/tree/master/bsp/gd32/risc-v/gd32vw553h-eval

方案一：可以使用git工具直接拉取RT-Thread整包：git clone https://github.com/RT-Thread/rt-thread.git

方案二：可以直接从git界面下载zip整包，本地解压；

RT-Thread ENV工具：https://www.rt-thread.org/download.html#download-rt-thread-env-tool

编译器工具链：https://www.gigadevice.com.cn/product/mcu/mcus-product-selector/gd32vw553hmq6

固件烧录工具GD32AllInOneProgrammer：https://www.gd32mcu.com/cn/download?kw=GD32+All-In-One+Programmer&lan=cn

1.2 环境配置

1.2.1 RT-Thread ENV工具配置

将1.1->第3小节：链接中下载的文件拷贝至工作文件夹(此处为笔者习惯，仅供参考，可跳过)；

打开路径中的exe文件运行RT-Thread ENV工具，此时该文件会自动配置Windows下的环境变量；

此处需要注意输出文件中包含的环境变量的设置，当我们解压并使用后，再次移动软件位置时，记得将环境变量同步更改，否则可能会报错，无法找到pkgs指令；若是不会修改环境变量，最简单的解决方案就是删除当前的ENV整包，然后在需要安装的位置重新解压，并运行即可；

当软件环境配置完成后，分别运行pkgs —upgrade、pkgs —update,此时观察仓库可以发现仓库中增加了packages文件夹，里面包含了gd32的lib库；

1.2.2 GD32编译链环境搭建

对于任意一款芯片的编译肯定都需要适配交叉编译工具链，一般这部分厂商都有提供，本次需要将交叉编译工具集成到RT-Thread的环境中；

由于在第一章1.1已经下载好了编译器工具链，首先需要选择一个自己想要放置编译链的地方解压工具链；

然后在RT ENV环境下运行下面命令，注意：PTAH=后面跟着的路径需要改为自己的路径，下方指令不可直接复制粘贴使用！下方指令不可直接复制粘贴使用！下方指令不可直接复制粘贴使用！

setRTT_EXEC_PATH=E:\GD32\GD32VW5\GD32EmbeddedBuilder_v1.5.4_Rel\Tools\RISC-V Embedded GCC\8.2.0-2.2-20190521-0004\bin

运行完成后，在gd32vw553h-eval的目录下直接执行scons -j128编译即可；

记得一定要在\rt-thread-master\bsp\gd32\risc-v\gd32vw553h-eval，这个目录下执行，其中j后面跟着的数字是指使用几个核进行编译，可根据自己的电脑实际性能调整；

编译完成后既可以看到文件夹中多了rtthread.bin文件，该文件就是后面需要下载到板卡的二进制文件；

1.3 固件烧录(直接按照git中完成)

固件烧录需要使用上述的第一章1.1中下载的GD32AllInOneProgrammer软件，烧录说明位于烧录软件下的Doc文件夹，或在线搜索使用方法，下述是烧录的示例：

需要注意的是使用上述软件烧录时需要将boot1置为高电平，烧录结束后重新设置为低电平，手动调整板载的boot跳线帽。

运行结果：烧录完毕后，使用串口连接自己的串口终端软件，即可通过串口与开发板交互；

1.4. 测评结论

GD32这款板子在环境搭建上相对还是比较简单的，基本可以无脑跟着Git中的指引一步步完成开发环境的搭建，无需开发者到处寻找资料；同时搭建开发环境所需的软件包也比较集中，且容易获取；

2 VSCode软件调试环境搭建

2.1 调试环境搭建

配置VSCode调试环境，首先在第一章中已经下载好了《GD32EmbeddedBuilder》，调试环境配置时需要用到该文件夹中的Tools；

其次在BSP根目录下执行下述命令，生成VSCode工程所需文件。

scons —target=vs

在VSCode安装扩展插件Cortex-Debug，版本v1.4.4。

完成上述工作后，点击运行和调试选项，创建一个launch.json配置文件，配置文件示例如下：

{"version":"0.2.0","configurations":[ { "name":"Cortex Debug", "cwd":"${workspaceFolder}", "executable":"${workspaceFolder}/rtthread.elf", "request":"launch", "type":"cortex-debug", "servertype":"openocd", "serverpath":"E:/GD32/GD32VW5/Tools/GD32EmbeddedBuilder_v1.5.2.30854/Tools/OpenOCD/xpack-openocd-0.11.0-3/bin/openocd", "configFiles": [ "${workspaceFolder}/openocd_gdlink.cfg" ], "runToEntryPoint":"main", "showDevDebugOutput":"raw", "toolchainPrefix":"E:/GD32/GD32VW5/Tools/GD32EmbeddedBuilder_v1.5.2.30854/Tools/RISC-V Embedded GCC/8.2.0-2.2-20190521-0004/bin/riscv-none-embed" }]}

这里需要注意如果你的${workspaceFolder}工作空间不是当前的路径，可以自行将${workspaceFolder}相关的路径改为自己launch.json的绝对路径/相对路径使用；

上述文件中的部分字段需要根据用户环境进行修改，格式需与示例一致：

“serverpath”：该字段需要改为用户的openocd所在路径，openocd工具位于GD32EmbeddedBuilder工具包中。

“toolchainPrefix”：该字段需修改为用户的工具链所在路径，工具链位于GD32EmbeddedBuilder工具包中。

完成上述配置后即可点击调试选项进行调试，调试时boot管脚均置为低电平即可，调试时同样会进行固件下载。

2.2 调试环境测试

在工程界面点击Cortex Debug，即可进入调节界面；