RT-Thread BSP模版工程创建：从零搭建STM32芯片开发环境

原创

于 2026-02-07 03:56:42 发布 · 943 阅读

在开始使用RT-Thread BSP模版为STM32芯片创建工程之前，我们需要先搭建一个稳定可靠的开发环境。对于嵌入式开发来说，环境配置是第一步，也是最关键的一步。很多初学者在这里会遇到各种奇怪的问题，其实大多数都是因为环境没有配置正确。

我推荐使用Linux系统进行RT-Thread开发，特别是Ubuntu发行版。Ubuntu有着完善的包管理体系和活跃的社区支持，能够很好地满足嵌入式开发的需求。首先我们需要安装一些基础开发工具，打开终端输入以下命令：

sudo apt update
sudo apt install git wget make gcc g++ python3 python3-pip

这些工具是后续开发的基础，git用于代码版本管理，make和gcc是编译工具链，python3则是RT-Thread的env工具和scons构建系统所依赖的。

接下来安装ARM交叉编译工具链，这是编译STM32程序的关键。我建议使用gcc-arm-none-eabi，这是ARM官方维护的交叉编译工具链，兼容性最好：

sudo apt install gcc-arm-none-eabi

安装完成后可以验证一下是否安装成功：

arm-none-eabi-gcc --version

如果能看到版本信息，说明工具链安装成功。有时候系统自带的版本可能比较旧，你也可以从ARM官网下载最新的工具链，然后手动添加到PATH环境变量中。

提示：在Linux下开发嵌入式程序，最好避免使用root权限进行操作，以免造成权限混乱。如果某些操作需要root权限，可以使用sudo临时提权。

现在我们来安装RT-Thread的开发环境。RT-Thread提供了env工具，这是一个集成了编译工具链、配置工具和包管理器的开发环境，大大简化了开发流程。

首先克隆RT-Thread的源码仓库：

git clone https://github.com/RT-Thread/rt-thread.git
cd rt-thread

env工具位于rt-thread目录下的tools文件夹中。我们需要设置环境变量，让系统能够找到env工具：

export RTT_ROOT=/path/to/your/rt-thread
export PATH=$PATH:$RTT_ROOT/tools

为了方便以后使用，建议将这两个环境变量添加到.bashrc文件中：

echo "export RTT_ROOT=/path/to/your/rt-thread" >> ~/.bashrc
echo "export PATH=\$PATH:\$RTT_ROOT/tools" >> ~/.bashrc
source ~/.bashrc

env工具依赖于Python环境，我们需要安装一些必要的Python包：

pip3 install scons
pip3 install pywin32    # 如果在Windows下开发需要这个
pip3 install requests   # 用于包管理器

scons是RT-Thread使用的构建工具，比传统的make更加智能和易用。它能够自动处理头文件依赖，支持增量编译，大大提高了编译效率。

现在我们可以测试一下env环境是否配置正确：

scons --version

如果能看到scons的版本信息，说明环境配置成功。有时候可能会遇到Python路径问题，这时候需要检查python3是否正确安装，并且确保pip3安装的包在PATH中。

注意：在不同的Linux发行版中，python命令可能指向python2，而我们需要的是python3。如果遇到问题，可以尝试使用python3 explicitly来运行scons。

环境配置好后，我们就可以开始创建BSP模版工程了。BSP（Board Support Package）是板级支持包，包含了特定硬件平台的驱动程序和配置文件。RT-Thread为各种STM32芯片提供了丰

标签

#RT-Thread #BSP #STM32 #嵌入式开发