RT-Thread零基础快速入门第1讲——新建工程

一、前言

这一讲我来给大家介绍几种常用的新建工程的方法，在开始之前，我们需要先安装好RT-thread相关的环境，这个在我上一讲有详细的教程，没有看过的同学可以点下面的链接或者在我的博文RT-thread专栏看一下。

RT-Thread零基础快速入门第0讲——环境安装：https://blog.csdn.net/ShenZhen_zixian/article/details/105019464

另外，我也是刚入门RT-thread，有些地方可能讲的不好或者不全面，勿怪勿怪，如果发现文章有误，请一定要指正，谢谢！！！

二、使用ENV工具新建项目工程

这是我最推荐大家使用的一种方法，因为通过ENV工具，我们可以非常方便的增加和删减我们所需驱动的上层接口，再通过STM32CubeMX配置使能底层驱动，就可以根据我们的需要建立和修改工程。

env详细的用法可以在RT-thread官方的文档中心查看，我这里只讲新建工程相关的用法。当然了，后面会根据我的入门教程，逐一介绍env的其他用法。

env使用视频教程链接：https://www.rt-thread.org/document/site/tutorial/env-video/
env创建工程教程链接：https://www.rt-thread.org/document/site/application-note/setup/standard-project/an0017-standard-project/

使用env生成工程

第一步：下载RT-thread官方源码

RT-thread官方源码下载链接：https://www.rt-thread.org/page/download.html
百度网盘地址：https://pan.baidu.com/s/1pAhjlSxzLdJ68kDjNJXJgA
提取码：46qf

如果官方的链接下载比较慢的话可以试一下在我的网盘上面下载

第二步：打开源码里面的bsp文件夹，找到你需要建立工程的芯片型号

需要注意的是，源码文件夹所在的路径上不能有中文命名的文件夹，不然后面不能正常使用env

建议用版本新一点的源码，因为旧版本的源码包含的芯片会少一些，有些芯片的固件库没有。

第三步：在芯片目录下右键，打开env，输入scons --dist，等待命令执行完毕

scons –dist命令是用来搭建项目框架的，使用此命令会在 BSP 目录下生成 dist 目录，这便是开发项目的目录结构，包含了RT-Thread源码及BSP相关工程，不相关的BSP文件夹及libcpu都会被移除，并且可以随意拷贝此工程到任何目录下使用。

当然，你也可以直接用官方的源码作为你的项目工程，不过这样一来，你的工程文件占用的内存就比较大了。如果你要用官方源码作为工程，可以直接跳到第五步。

第四步：打开dist文件夹，把我们需要的项目工程移到别的文件路径

当然，就放在这里也可以，就是下次需要打开项目工程的时候不好找

第五步，在新的工程目录下重新打开env，输入menuconfig

输入的指令可以只输入前面几个字母，然后按tab键，会自动补全后面的字母

在menuconfig页面，我们可以配置我们需要的硬件驱动，软件包等。例如，我们把串口2和串口3打开，可以在Hardware Drivers Config/On-chip Peripheral Drivers/Enable UART目录下把Enable UART2和Enable UART3打开

menuconfig具体的操作方法可以在官方的文档中心的Env用户手册查看

Env用户手册链接：https://www.rt-thread.org/document/site/programming-manual/env/env/

第六步：按esc退出menuconfig并保存

退出的时候会提示你是否要保存，点yes保存配置

第七步：在env命令窗口输入scons –target=mdk5，生成新的项目工程

也可以输入scons –target=mdk4或者scons –target=iar，根据自己的需要生成对应的工程即可

如果你的目录没有错误的话，生成新的工程会有下面这些提示，如果要加入工程的文件没有在项目所在的文件夹里面的话，会提示找不到这个文件.

使用STM32CubeMX配置底层驱动

第一步：打开我们新建的工程目录，找到board/ CubeMX_Config目录下的CubeMX_Config.ioc，这是STM32CubeMX的工程文件

第二步：打开CubeMX_Config.ioc

如果你的STM32CubeMX没有安装项目工程芯片对应的固件库，会有下面的提示，点击Download下载固件库。（如果你已经下载了最新的固件库，而工程用的是老版本的固件库，也需要再下载旧的固件库）

第三步：根据需要配置芯片的参数

使用STM32CubeMX我们可以根据需要配置单片机的所有参数，比如晶振时钟，使能定时器、设置串口波特率等

我这里只举一个例子，具体的用法比较多，我这里就不多说了，你们可以在网上找一下教程

第四步：点击Project Manger，点击GENERATE CODE等待生成新的工程即可

生成新的工程之后会有下面的提示，点Close即可，不需要打开工程，因为打开的这个工程是不包含RT-thread框架的，是裸机工程。

实际上我们用STM32CubeMX只是修改工程目录下面的相关的底层驱动文件而已

第五步：打开工程目录下的项目文件，编译

Keil5.24以上版本编译的时候可能会有一个问题，就是编译的时候会突然卡住一段时间，虽然最后都能编译成功，但是需要的时间会比较长。解决的办法是：打开Project/Options for Target/Output，把Browse Inoformation前面的勾去掉，不过这样一来，我们就不能跳转到声明和定义了。所以建议大家还是不要用keil写代码了，用过别的编程软件的同学应该都知道，keil本身写代码也不是特别的方便，我们可以用别的编程软件写代码（比如Visual Studio Code、soucer insigned等），再用keil编译就行了

三、使用RT-Thread Studio新建项目工程

我基本不用RT-Thread Studio建工程，还是比较喜欢用env建工程。而且据说用RT-Thread Studio建的工程有时候会出问题，因为这个软件也是刚开发出来的。但是，不可否认RT-Thread Studio这个软件用起来的确非常便捷，而且它也可以编译和烧录，摆明了就是要替代MDK嘛，虽然要完全替代MDK还有比较长的路要走，但是前景是好的，等这个软件真正完善的时候，相信会是一个非常强大的软件。

在官方的文档中心有非常详细的RT-Thread Studio使用教程，所以在这里我就不多说了，感兴趣的同学可以去看一下。

RT-Thread Studio使用教程链接：https://www.rt-thread.org/document/site/rtthread-studio/nav/#

四、在原有的工程上移植RT-thread

这种方法我个人是不建议大家去用的，既然选择了RT-Thread，有些习惯我们就需要去改变，以前我们可能会经常在keil里面把新的文件加到工程里面，然后把头文件路径加进来，或者去修改底层的库函数的代码，比如把某个宏定义的注释打开，等等，包括我自己，其实也是经常这样做。但是，在使用RT-thread这个操作系统的时候，这些操作效率是很低的，我们用RT-thread主要的精力应该放在应用层的开发，而不是去配底层驱动。例如，我们用env生成一个工程之后用keil把新的文件加进来，等我们调试完成之后发现还需要在env中再增加其他软件包，这时用env生成新的工程是不包含之前用keil加到工程的文件的，你还需要继续加一遍。所以，最好的方法是直接用env一次性把所有需要的文件包含进来，把所有配置都设置好。

移植的方法在官方的文档中心也有详细的介绍，包括keil，iar等开发环境的教程都有，我就不多说了，感兴趣的同学可以去看一下。

使用keil移植RT-Thread教程链接：https://www.rt-thread.org/document/site/tutorial/nano/nano-port-keil/an0039-nano-port-keil/
使用IAR移植RT-Thread教程链接：https://www.rt-thread.org/document/site/tutorial/nano/nano-port-iar/an0040-nano-port-iar/

五、结束语

关于RT-Thread新建工程的介绍就到这里，如果你觉得有用，可以点赞收藏，谢谢！！！
后面我会持续更新一些RT-Thread的项目开发，感兴趣的同学可以关注博主，谢谢！！！

RT-thread相关教程汇总：https://blog.csdn.net/ShenZhen_zixian/article/details/120563891