# GD32VF103XWOS

**Repository Path**: xwos/GD32VF103XWOS

## Basic Information

- **Project Name**: GD32VF103XWOS
- **Description**: 此工程是在GD32VF103上移植XWOS的示例工程。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-07-06
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 介绍

本项目包括一个示例工程。此工程是在GD32VF103上移植XWOS的示例工程。

+ 硬件主页：<https://wiki.sipeed.com/hardware/zh/longan/Nano/Longan_nano.html>
+ IDE：[NucleiStudio](https://www.riscv-mcu.com/nucleistudio.html)
+ MCU：GD32VF103


## XWOS

玄武操作系统（XWOS®）开发于2015年，是一款运行在嵌入式微控制器上的通用实时操作系统，
主要面向可靠、实时、安全的应用领域，包括汽车、物联网、工控等。

+ <http://xwos.tech/>
+ <http://xwos.org/>
+ <https://xwos.gitee.io/>
+ <https://xwos.github.io/>


# 下载源码

```shell
git clone --recursive https://gitee.com/xwos/GD32VF103XWOS.git
```


## 源码结构

+ App：用户程序入口
+ Board：电路板描述层
+ XWOS：XWOS
+ GD32VFmwLib：GD32V官方的驱动库
+ Tools：工具
+ CHANGELOG.md：变更日志
+ LICENSE.txt：开源协议
+ README.md：使用说明
+ .git：git仓库
+ .gitignore：git commit时忽略的文件
+ .gitmodules：git子仓库
+ .gitemplate：git commit的模板
+ .cproject：NucleiStudio工程文件
+ .project：NucleiStudio工程文件
+ .settings：NucleiStudio工程文件
+ DebugConfigurations：NucleiStudio的调试配置文件


# 开发环境搭建指南

## 安装IDE

+ 1. 下载并安装 [NucleiStudio](https://www.riscv-mcu.com/nucleistudio.html)

## 安装工具集合

`xwtc` 是编译XWOS的工具集合，可以从百度网盘下载，按照内部 **说明.md** 安装就可。

+ <https://pan.baidu.com/s/1WwSaEajt6JqgMOLOa8iPEQ>
+ 提取码：xwos

若用户使用 **Ubuntu** 作为开发环境，需要额外安装一些工具：

```shell
sudo dpkg-reconfigure dash # 选择“否”
sudo apt install build-essential
sudo apt-add-repository ppa:kelleyk/emacs
sudo apt-get update
sudo apt install emacs28 # 如果是无图形界面的服务器，改为emacs28-nox
```


## 导入工程

通过菜单 **File --> Open Projects from File System...** 可导入工程。


## 设置编译器路径

编译前，需要设置编译器路径。
如果用户已经正确安装 `xwtc` 并配置环境变量 `PATH` ，当前配置可自动解析为正确的路径。

打开 `Board/makefile` ，在最开始处增加环境变量 `CROSS_COMPILE` 的定义可以覆盖默认编译器路径，例如：

+ Windows: `export CROSS_COMPILE = C:/NucleiStudio/toolchain/gcc/bin/riscv-nuclei-elf-`
+ Ubuntu: `export CROSS_COMPILE = /usr/local/NucleiStudio/toolchain/gcc/bin/riscv-nuclei-elf-`


## 编译

有两种方法可以编译，两种方法结果产生一样：

+ 打开终端，并将当前路径切换到工程的 `Board` 目录，执行 `make` 命令。
+ 在IDE中点击 **编译** 按钮。


## 调试

工程内提供 **RV-Debugger Lite** 的调试配置，通过菜单 **Run --> Debug Configurations...** 选择 **GD32VF103XWOS-Debug** 调试。

### 调试中复位

调试中复位的方法：

+ 1. 在 `xwos_main()` 或其他地方设置一个断点；
+ 2. 在右键菜单中选择 **Restart** ；
+ 3. 按一下复位按键；
+ 4. 按F8继续运行程序 ；


# 客制化

## 工程改名

1. 可通过命令 `find . -type f -name "*GD32VF103XWOS*"` 搜索所有文件名包含 `GD32VF103XWOS` 的文件，将其改为 **新工程名** 。
2. 可通过命令 `find . -path "./.git" -prune -o -type f -exec grep -i -H "GD32VF103XWOS" {} \;` 搜索所有内容包含 `GD32VF103XWOS` 的文件，然后依次打开，将其全部替换为 **新工程名** 。


## 连接到外部静态库

可在文件 `Board/lib.mk` 中定义外部静态库：

+ `EINCDIRS` ：外部静态库头文件列表
+ `ELIBS` ：外部静态库列表