目录
使用 Env 创建 RT-Thread 项目工程
本文用来指导用户按照标准方式创建和管理 RT-Thread 工程。
简介
RT-Thread 完全开源开放,支持几十款 BSP,支持多种编译器,支持众多基础组件以及数量持续增长的软件包,然而对于工程项目开发来说,只需要支持一款或者有限几款 MCU,使用一种熟悉的 IDE 开发环境,使用有限的外设和组件,本文档旨在指导用户在全功能 RT-Thread 版本基础上,根据项目需求搭建 RT-Thread 工程框架。
本文准备资料如下:
-
安装好 MDK 软件或者 IAR 软件。
标准工程管理
选择 BSP
用户获取 RT-Thread 源代码后需要根据自己手上的开发板型号找到对应的 BSP,就可以运行 BSP 提供的默认工程。大部分 BSP 都支持 MDK﹑IAR 开发环境和 GCC 编译器,并且已经提供了默认的 MDK 和 IAR 工程。
本文后续章节将使用正点原子潘多拉开发板演示相关操作,该开发板对应的 BSP 为 stm32l475-atk-pandora,默认使用串口 1 作为 shell 控制台输出使用串口。
搭建项目框架
在 BSP 目录下打开 Env 工具,运行 scons --dist
命令。使用此命令会在该 BSP 目录下生成 dist 目录,这便是开发项目的目录结构,RT-Thread 源码位于项目文件夹内,可以随意拷贝 dist 文件夹的工程到任何目录下使用。
进入dist目录下面的 stm32f4xx-HAL 工程目录,项目框架目录结构如下图所示:
项目框架主要目录及文件的说明如下表所示:
文件 / 目录 | 描述 |
---|---|
applications | 用户应用代码目录 |
drivers 或 board | RT-Thread 提供的底层驱动/板级相关的移植 |
Libraries | 芯片官网下载的固件库 |
rt-thread | RT-Thread 源代码 |
Kconfig | menuconfig 使用的文件 |
project.ewww | 用户使用的 IAR 工程文件 |
project.uvprojx | 用户使用的 MDK 工程文件 |
template. uvprojx | MDK 工程模板文件 |
SConscript | SCons 配置工具使用的文件 |
SConstruct | SCons 配置工具使用的文件 |
README.md | BSP 说明文件 |
rtconfig.h | BSP 配置头文件 |
Note
注:此命令从 RT-Thread 3.1.0 正式版才开始支持。
修改工程模板
用户一般都需要根据自己的需求对工程做一些工程配置,比如配置 MCU 型号,设置调试选项等。建议大家直接修改工程模板,这样使用 Scons 相关命令生成的新工程也都会包含对模板的修改。MDK 的模板工程为 template.uvprojx。IAR 的模板工程为 template.eww。注意:直接双击打开 IA