RT-Thread-sdk-bsp-gd32vf103v-eval提交记录(一)RT-Thread问答社区

sdk-bsp-gd32vf103v-eval提交记录(一)

发布于 2022-04-30 23:10:05 浏览：888 订阅该版

[tocm]

上一次做了ch32v103r-evt的sdk-bsp，[CH32V103R-EVT  RT-Thread Studio开发板支持包制作](https://club.rt-thread.org/ask/article/927d249dba33010e.html)

这次把gd32v103v-eval的sdk-bsp做了，和上次一样我打算从rtthread源码的gd32v103v-eval bsp直接导入，然后调整。

由于涉及的gcc 和debug工具不是现成的，加上源码部分需要优化，大概分三篇介绍：

1. gd32vf103v-eval 在rtthread studio可编译的demo 工程，gcc和openocd测试

2. PR nuclei gcc , nuclei openocd 和 sdk-bsp-gd32vf103v-eval（v1.0.0版本）

3. 优化源码部分，提供jlink调试配置（v1.0.1版本）

# 1 准备

## 1.1 rtthread v4.1.0（latest）

```shell
$ git ck v4.1.0
Note: switching to 'v4.1.0'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by switching back to a branch.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -c with the switch command. Example:

git switch -c <new-branch-name>

Or undo this operation with:

git switch -

Turn off this advice by setting config variable advice.detachedHead to false

HEAD is now at 4f5d1b0ce [update] ChangeLog for RT-Thread_v4.1.0 (#5735)

LT@DESKTOP-Win10 MINGW64 /e/WorkSpaces/rt-thread ((v4.1.0))

```

> 只是临时用一下，就直接切换到HEAD，不建分支了

## 1.2 参考资料

[官方开发板资源包制作指导](https://www.rt-thread.org/document/site/#/development-tools/rtthread-studio/um/studio-user-manual?id=%e5%bc%80%e5%8f%91%e6%9d%bf%e8%b5%84%e6%ba%90%e5%8c%85%e5%88%b6%e4%bd%9c)

# 2 导入BSP工程

## 2.1  从RT-Thread Bsp到工作空间

![image-20220430194827011.png](https://oss-club.rt-thread.org/uploads/20220430/a083235efcb6cc6496e787443a8d088f.png.webp)

## 2.2 创建gd32vf103v-eval-demo

基于bsp创建gd32vf103v-eval-demo 工程，该工程作为后面做sdk-bsp的基础 。

![image-20220430195413202.png](https://oss-club.rt-thread.org/uploads/20220430/588110c501b6adc3dcae9696b7647a0d.png.webp)

很顺利，没有报错

![image-20220430195544819.png](https://oss-club.rt-thread.org/uploads/20220430/9da74176c4e4dc54c15c2d76b952f11d.png.webp)

# 3 调整配置

## 3.1 配置工具链

![image-20220430195909589.png](https://oss-club.rt-thread.org/uploads/20220430/69a986653433244a2dcf878f1900cef8.png.webp)

## 3.2 同步scons配置到项目

现在工程src, include ,group基本都是错了，包含了很多不该包含的文件，或者找不到文件，需要借助scons 快速生成正确的配置。

### 3.2.1 先重配 target

该步骤可以省略。

基于GD32VF103XB target新建Debug target，并把GD32VF103XB删除

![image-20220430200937670.png](https://oss-club.rt-thread.org/uploads/20220430/5bda49efe5aa4ef9c60f235f6173ab67.png.webp)

### 3.2.2 配置projcfg.ini

.setting /projcfg.ini

```
#RT-Thread Studio Project Configuration
#Sat Apr 30 19:54:19 CST 2022
cfg_version=v3.0
board_name=gd32vf103v-eval
example_name=
hardware_adapter=J-Link
project_type=rt-thread
board_base_nano_proj=false
chip_name=GD32VF103VBT6
selected_rtt_version=latest
bsp_version=1.0.0
os_branch=4.1.0
project_base_rtt_bsp=true
output_project_path=E\:WorkSpacesRT_Thread_Studiogd32vf103v-eval-demo
is_base_example_project=false
is_use_scons_build=true
project_name=gd32vf103v-eval-demo
os_version=4.1.0
bsp_path=
```

### 3.2.3 同步scons配置至项目

然后右击选择`同步scons配置至项目`

![image-20220430200320284.png](https://oss-club.rt-thread.org/uploads/20220430/2a3421cffc98f39502c2d85ca6c6c609.png.webp)

打开配置发现已自动更新了include and src, 手动删除上面的错误路径(GUN C ，assembly include)

![image-20220430200549562.png](https://oss-club.rt-thread.org/uploads/20220430/e79a89a63197813ce2e90e6177847ce5.png.webp)

编译测试一下，

![image-20220430202611030.png](https://oss-club.rt-thread.org/uploads/20220430/64f65375f572f970b5db165bba9be660.png.webp)

很不幸scons对scr 过滤部分未生效

![image-20220430202838912.png](https://oss-club.rt-thread.org/uploads/20220430/dd4861972580aa4993024ae7c626877d.png.webp)

估计是没有添加一个工程文件夹，scons更新失败，经探索按照下面步骤可解决：

1）手动添加一个排除构建

![image-20220430203017133.png](https://oss-club.rt-thread.org/uploads/20220430/753b9c61ee987c23e0c10028d541d1d6.png.webp)

> 关于make clean 失败问题，当你编译通过后，再次清理这个问题就不存在！
>
> ![image-20220430212251086.png](https://oss-club.rt-thread.org/uploads/20220430/88c4a0df19428bee2a36e115c32dfbff.png.webp)

>
> 当前可以配置成make clean2 提前避免，这个目标在./makefile.targets中定义
>
> ![image-20220430212533260.png](https://oss-club.rt-thread.org/uploads/20220430/ab61648cdbfc6de002ba2fedea37626b.png.webp)

>
>

2）再次同步scons配置到项目

3）刷新项目

![image-20220430203736906.png](https://oss-club.rt-thread.org/uploads/20220430/2788d22ae0e7c4fa72966129d34f49be.png.webp)

再次编译

![image-20220430203850950.png](https://oss-club.rt-thread.org/uploads/20220430/fffce3620b1b6aea6f30f6094b2ac0ab.png.webp)

这个是汇编头文件include位置有问题，添加汇编头文件位置

![image-20220430204051804.png](https://oss-club.rt-thread.org/uploads/20220430/eaf9952703dec62a5de010b5c22924a4.png.webp)

## 3.3 libc头文件问题

解决完include , exclude 配置后，再次编译出现下面问题

![image-20220430204308297.png](https://oss-club.rt-thread.org/uploads/20220430/b9e558c8c9f7601618e29532578cc9fd.png.webp)

这个问题很奇怪，当前工程env下已经能编译了，头文件索引应该没问题了。

![image-20220430204553070.png](https://oss-club.rt-thread.org/uploads/20220430/359170bf310393621cf72dabee35791f.png.webp)

通过追踪调用关系，发现stdio.h的61行使用`#include<sys/type.h>`本意是想包含gcc工具链下的sys/select.h 文件

但是studio ide错误地去包含rt-thread/components/libc/compilers/newlib/legacy/_select/sys/select.h

![image-20220430210947912.png](https://oss-club.rt-thread.org/uploads/20220430/4675644c6cf0d2144f651937db6ca017.png.webp)

rt-thread/components/libc/compilers/newlib/legacy/_select是一个include路径，该路径下正好有个sys/select.h，IDE就包含进来了

**这像是一个IDE的bug,<xxx.h>应该先在gcc工具链下查找，没发现再从本地Include路径里查找。**

工程里搜索一下select.h，发现都是`#include<sys/select.h>`

![image-20220430211243159.png](https://oss-club.rt-thread.org/uploads/20220430/76fc0e90fb05b4fa18e93d6274014939.png.webp)

可以直接把rt-thread/components/libc/compilers/newlib/legacy/_select/sys/select.h这个文件删了，再次编译顺利通过。

![image-20220430211450224.png](https://oss-club.rt-thread.org/uploads/20220430/a3a17d51740c27808f20cccaef9b00af.png.webp)

# 4 OpenOCD下载debug

工程已经编译过了，下面就是下载测试一下。gd32vf103v-eval自带了一个gd-link，我在NucleiStudio IDE中借助Nuclei OpenOCD已经可以下载debug了

不幸的是当前RT-Thread Studio SDK里并没有Nuclei OpenOCD

![image-20220430213011585.png](https://oss-club.rt-thread.org/uploads/20220430/10badf3f44b635c53d654d3a4a459a5a.png.webp)

## 4.1 PyOCD

这个我试过了，提示不识别这个芯片，目前还不支持gd32vf103v

## 4.2 OpenOCD

OpenOCD本质差不多，就是各家可能做了更改，不兼容了。其实我们只需要一个RT-Thread Studio提供一个OpenOCD的配置界面。

下面开始曲线救国

### 4.2.1 参考 先楫HPM6750-HPMirco

下载HPM6750-HPMirco-EVKMINI  和 OpenOCD-HPMicro

![image-20220430213842335.png](https://oss-club.rt-thread.org/uploads/20220430/68f2bb2633279b95d516a280677d0554.png.webp)

然后新建一个参考工程**HPM_blink-led**

### 4.2.2 hardware_adapter

查看`.setting/projcft.ini` 里 `hardware_adapter`字段属性值微`FT2232`

![image-20220430214220754.png](https://oss-club.rt-thread.org/uploads/20220430/fbaf2615e72d6bd4c6272aef5f03cffe.png.webp)

更改gd32vf103v-eval-demo工程的 .setting/projcft.ini 的hardware_adapter 字段为 FT2232

### 4.2.3  OpenOCD.Debug.rttlaunch

拷贝 `HPM_blink-led/.setting/HPM_blink_led.OpenOCD.Debug.rttlaunch` 到 `gd32vf103v-eval-demo/.setting/`下

并重命名为`gd32vf103v-eval-demo.OpenOCD.Debug.rttlaunch`

却发现无法打开,但我之前做了一个版本是没问题的。**最后发现工程名不能太长，太坑了。**

![image-20220430222204810.png](https://oss-club.rt-thread.org/uploads/20220430/d3f2dda7ccdd3a10af3783ec4860b56c.png.webp)

把工程重命名为gd32vf103-eval ，可以打开OpenOCD配置界面

![image-20220430222838333.png](https://oss-club.rt-thread.org/uploads/20220430/98e9b29de7afafe9af57871f76e33716.png.webp)

## 4.3 配置OpenOCD

参考NucleiStudio IDE中OpenOCD，调整debugger界面如下

![image-20220430222913626.png](https://oss-club.rt-thread.org/uploads/20220430/7b0ce2f173f0d28b800819ca3d422aa5.png.webp)

## 4.4 openocd_gd32vf103.cfg

按配置，拷贝nuclei_sdk/SoC/gd32vf103/Board/gd32vf103v_eval/openocd_gd32vf103.cfg到工程更目录下

## 4.5 愉快地下载debug

![image-20220430223745531.png](https://oss-club.rt-thread.org/uploads/20220430/e2391c747a866aef5b2c067b732a9aac.png.webp)

断点复位测试正常

![image-20220430223949101.png](https://oss-club.rt-thread.org/uploads/20220430/f4af08a219ae981a3fe3f4f1943804ad.png.webp)

MSH正常

```
 \ | /
- RT -     Thread Operating System
 / | \     4.1.0 build Apr 30 2022 22:32:59
 2006 - 2022 Copyright by RT-Thread team
msh >ps
thread   pri  status      sp     stack size max used left tick  error
-------- ---  ------- ---------- ----------  ------  ---------- ---
tshell    20  running 0x00000140 0x00001000    16%   0x00000008 000
tidle0    31  ready   0x000000b0 0x00000100    68%   0x00000019 000
timer      4  suspend 0x000000c0 0x00000200    37%   0x00000009 000
msh >

```

**第一部分Demo工程大功告成**