Env 是 RT-Thread 推出的开发辅助工具,针对基于 RT-Thread 操作系统的项目工程,提供编译构建环境、图形化系统配置及软件包管理功能。
其内置的 menuconfig 提供了简单易用的配置剪裁工具,可对内核、组件和软件包进行自由裁剪,使系统以搭积木的方式进行构建。
Env 工具包含了 RT-Thread 源代码开发编译环境和软件包管理系统。
https://git-scm.com/downloads
,根据向导正确安装 git,并将 git 添加到系统环境变量。RT-Thread 软件包环境主要以命令行控制台为主,同时以字符型界面来进行辅助,使得尽量减少修改配置文件的方式即可搭建好 RT-Thread 开发环境的方式。 打开 Env 控制台有两种方式:
进入 Env 目录,可以运行本目录下的 env.exe
,如果打开失败可以尝试使用 env.bat
。
Env 目录下有一张 Add_Env_To_Right-click_Menu.png
(添加 Env 至右键菜单.png) 的图片,如下:
根据图片上的步骤操作,就可以在任意文件夹下通过右键菜单来启动 Env 控制台。效果如下:
[!NOTE] 注:因为需要设置 Env 进程的环境变量,第一次启动可能会出现杀毒软件误报的情况,如果遇到了 杀毒软件误报 ,允许 Env 相关程序运行,然后将相关程序添加至白名单即可。
scons 是 RT-Thread 使用的编译构建工具,可以使用 scons 相关命令来编译 RT-Thread 。
例如工程目录为: rt-thread\bsp\stm32f429-apollo
:
Python & scons
环境,只需在 rt-thread\bsp\stm32f429-apollo
目录中运行 scons
命令即可使用默认的 ARM_GCC 工具链编译 bsp。编译成功:
如果使用 mdk/iar 来进行项目开发,可以直接使用 BSP 中的工程文件或者使用以下命令中的其中一种,重新生成工程,再进行编译下载。
scons --target=iar
scons --target=mdk4
scons --target=mdk5
更多 scons 教程,请参考 《Scons 构建工具》
menuconfig 是一种图形化配置工具,RT-Thread 使用其对整个系统进行配置、裁剪。
进入 BSP 根目录,输入 menuconfig
命令后即可打开其界面。 menuconfig 常用快捷键如图所示:
menuconfig 有多种类型的配置项,修改方法也有所不同,常见类型如下:
选择好配置项之后按 ESC 键退出,选择保存修改即可自动生成 rtconfig.h 文件。此时再次使用 scons 命令就会根据新的 rtconfig.h 文件重新编译工程了。
RT-Thread 提供一个软件包管理平台,这里存放了官方提供或开发者提供的软件包。该平台为开发者提供了众多可重用软件包的选择,这也是 RT-Thread 生态的重要组成部分。
点击这里 可以查看到 RT-Thread 官方的提供的软件包,绝大多数软件包都有详细的说明文档及使用示例。
package 工具作为 Env 的组成部分,为开发者提供了软件包的下载、更新、删除等管理功能。
Env 命令行输入 pkgs
可以看到命令简介:
> pkgs
usage: env.py package [-h] [--update] [--list] [--wizard] [--upgrade]
[--printenv]
optional arguments:
-h, --help show this help message and exit
--update update packages, install or remove the packages as you set in
menuconfig
--list list target packages
--wizard create a package with wizard
--upgrade update local packages list from git repo
--printenv print environmental variables to check
在下载、更新软件包前,需要先在 menuconfig
中 开启 你想要操作的软件包
这些软件包位于 RT-Thread online packages
菜单下,进入该菜单后,则可以看如下软件包分类:
找到你需要的软件包然后选中开启,保存并退出 menuconfig 。此时软件包已被标记选中,但是还没有下载到本地,所以还无法使用。
pkgs --update
,该软件包自动下载;pkgs --update
,该软件包将会在本地进行更新;pkgs --update
。此时本地已下载但未被选中的软件包将会被删除。随着 package 系统的不断壮大,会有越来越多的软件包加入进来,所以本地看到 menuconfig 中的软件包列表可能会与服务器 不同步 。使用 pkgs --upgrade
命令即可解决该问题,这个命令不仅会对本地的包信息进行更新同步,还会对 Env 的功能脚本进行升级,建议定期使用。
menuconfig -s/--setting
命令来进行配置。使用 menuconfig -s
命令进入 Env 配置界面
按下回车进入配置菜单,里面共有 3 个配置选项
3 个选项分别为:
软件包自动更新功能:在退出 menuconfig 功能后,会自动使用pkgs --update
命令来下载并安装软件包,同时删除旧的软件包。本功能在下载在线软件包时使用。
自动创建 MDK 或 IAR 工程功能:当修改 menuconfig 配置后 ,必须输入 scons --target=xxx
来重新生成工程。开启此功能,就会在退出 menuconfig 时,自动重新生成工程,无需再手动输入 scons 命令来重新生成工程。
使用镜像服务器下载软件包:由于大部分软件包目前均存放在 GitHub 上,所以在国内的特殊环境下,下载体验非常差。开启此功能,可以通过 国内镜像服务器 下载软件包,大幅提高软件包的下载速度和稳定性,减少更新软件包和 submodule 时的等待时间,提升下载体验。
如果想在 menuconfig 的配置项中添加宏定义,则可以修改 BSP 下的 Kconfig 文件,修改方法可以在网络中搜索Kconfig语法
关键字获得详细的说明文档,也可以参考 RT-Thread 中的 Kconfig 文件或者已经支持过 menuconfig 的 BSP 中的 Kconfig 文件。
这里的新项目指的是,还未生成 .config 和 rtconfig.h 的全新开发的项目。因为这两个文件,只有在 menuconfig 第一次保存时才会创建。具体流程如下:
这里的旧项目指的是已经经过一段时间的开发,而且项目中存在已经修改过的 rtconfig.h文件 ,但是没有使用过 menuconfig 来配置的项目。具体流程如下:
scons --genconfig
命令根据已有的 rtconfig.h 生成 .config 文件,这里生成的 .config 文件保存了旧项目中 rtconfig.h 文件对项目的配置参数。实际开发项目时,开发者可能想要将已下载的软件包加入 git 管理,或者想自己管理该软件包。不希望 Env 工具再拉取该软件包的最新版本,此时可以使用用户软件包管理功能。
如果用户手动将 EasyFlash-v4.1.0
文件夹的后缀,也就是软件包的版本号删除,修改为 EasyFlash
,此时再次使用 pkgs --update
命令将不会再拉取 EasyFlash-v4.0.0
软件包。Env 工具此时认为 EasyFlash 软件包由用户管理,此时使用 pkgs --force-update
命令才可以重新拉取附带 version 的新版本软件包。
在 Env 环境下暂时不能直接使用 Python 提供的 pip 工具来安装更多模块。如果需要在 Env 环境下使用 pip 功能,可以按照如下方法重新安装 pip 工具:
从地址 https://bootstrap.pypa.io/get-pip.py 下载 get-pip.py 文件,存放在磁盘中。
在 Env 环境下执行 python get-pip.py
命令来重新安装 pip 工具。
pip 工具重新安装成功后,可以使用 pip install module-name
命令来安装所需模块。
A: 首先检查是否有中文路径。 检查 chcp 命令是否加入了系统环境变量,尝试使用 chcp 437 命令将字符格式改为英文。如果提示没有 chcp 命令,则考虑是没有加入到环境变量中。 chcp 命令所在的目录可能在 system32 目录,添加到环境变量即可。 Env 工具乱码问题传送门 。
'git' is not recognized as an internal or external command, operable program or batch file.
A: 没安装 git,需要安装 git 并加入环境变量。
A: 计算机右键–>> 属性—>> 高级系统设置—->> 环境变量,C:\Windows\System32
; 加入系统环境变量即可
A: 计算机右键–>> 属性—>> 高级系统设置—->> 环境变量,在管理员的用户变量中,新建变量名为 PYTHONHOME,变量值为:F:\git_repositories\env\tools\Python27
(是 Env 里面 Python 的安装路径),注意后面不要加 “;”,否则会无效。 如果添加 PYTHONHOME 没好,再用同样的方法添加 PYTHONPATH。就可以解决这个问题了。
有一篇博文详细的描述了这个问题:传送门在这里,如果想了解原理可以看一看。
A:
A: 可以查阅本章 在项目中使用 Env 章节。
A:
详细描述:出现错误 MissingConfiguration: registry dir D:\Program Files (x86)\Microsoft Visual Studio\VC98
not found on the filesystem
A: 在划线的目录新建一个 VC98 的空文件夹,就可以使用 scons 了。
A: 当前工作的 BSP 目录下缺少 Kconfig 文件,参考本文《新的项目添加 menuconfig 功能》 和 《旧项目添加 menuconfig 功能》。
A: 这是由于 windows 系统没有开启 Null Service
服务的缘故,常见于在 win10 的早期版本中(如版本号 1703),该问题有两种解决方法,第一种是开启 windows 更新将 windows 更新到最新版本,因为在后续的补丁中 windows 默认开启了该服务,第二种是参考该 link 手动开启 Null Service
服务。
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )