Skip to content

Commit

Permalink
update env manual
Browse files Browse the repository at this point in the history
  • Loading branch information
SummerGift committed Nov 14, 2017
1 parent c147798 commit 7a3a6bb
Showing 1 changed file with 23 additions and 24 deletions.
47 changes: 23 additions & 24 deletions zh/5chapters/01-chapter_env_manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,18 +22,16 @@ env工具包含了RT-Thread源代码开发编译环境和组件包管理系统

* env环境编译器默认使用GNU GCC,工具链目录默认设置为 `env\tools\gnu_gcc\arm_gcc\mingw\bin`。版本为:gcc version 5.4.1 20160919 (release)。

* 在电脑上装好git,git的下载地址为`https://git-scm.com/downloads`,根据向导正确安装git,并将git添加到系统环境变量。env工具提供的git安装包路径为:env\tools\git。组件包管理功能需要git的支持。
* 在电脑上装好git,git的下载地址为`https://git-scm.com/downloads`,根据向导正确安装git,并将git添加到系统环境变量。组件包管理功能需要git的支持。

* 注意在工作环境中,所有的路径都不可以有中文字符或者空格。


## 2.使用方法

RT-Thread 软件包环境主要以命令行控制台为主,同时以字符型界面来进行辅助,使得尽量减少修改配置文件的方式即可搭建好RT-Thread开发环境的方式。

![image](./figures/console_bat.png)

进入env目录,可以运行本目录下的 `console.bat `程序,它会配置一些环境变量,然后弹出控制台窗口。接下来对软件包的操作都是在控制台环境下进行的,下图为控制台窗口:
![image](./figures/console_exe.png)
进入env目录,可以运行本目录下的`console.exe`,如果打开失败可以尝试使用`console.bat`,它会配置一些环境变量,然后弹出控制台窗口。接下来对软件包的操作都是在控制台环境下进行的,下图为控制台窗口:

因为需要设置env进程的环境变量,第一次启动可能会出现杀毒软件误报的情况,如果遇到了杀毒软件误报,允许console运行,然后将console添加至白名单即可。这个问题正在修复当中。

Expand All @@ -46,43 +44,44 @@ RT-Thread 软件包环境主要以命令行控制台为主,同时以字符型
#### 第一步:切换到工程目录

打开控制台后,可以在命令行模式下使用cd命令切换到你想要配置的工程目录。
例如工程目录为`F:\git_repositories\ART_wifi\firmware\app`,先进入工程根目录。

#### 第二步:设置RTT_ROOT根目录
可以通过命令:

set RTT_ROOT=your_rtthread_root_path

的方式设置RT-Thread目录(其中your_rtthread_root_path请填写你的RT-Thread根目录位置,记住RT-Thread不要放于带空格或中文字符的目录路径下)
例如工程目录为:`rt-thread\bsp\stm32f429-apollo`,在命令行下使用cd命令切换到的bsp根目录。如果env和rt-thread不在一个盘符,可以先使用`e:`或者`d:`命令切换盘符,然后再使用cd命令

![image](./figures/set_rtt_root.png)
![image](./figures/cd_stm32f429_apollo.png)

#### 第三步:复制Kconfig文件到工程目录

在使用env的`menuconfig`命令配置功能前,如果设备工程目录(bsp)中没有相应的`Kconfig`文件,可将`env`目录下的`Kconfig_bsp`文件复制到bsp根目录中。

![image](./figures/copy2bsp.png)

在bsp根目录中改名为:

![image](./figures/renamekconfig.png)

#### 第四步:更新env的在线组件包仓库列表
#### 第二步:更新env的在线组件包仓库列表

在使用`menuconfig`命令之前还需要使用

pkgs --upgrade

命令来更新env的组件包仓库列表
命令来更新env的组件包仓库列表。(无需每次更新,需要查看最新包列表时更新即可。)

![image](./figures/upgrade_from_gitpackages.png)

#### 第五步:使用menuconfig开始配置项目
#### 第三步:使用menuconfig开始配置项目

现在就可以在设备工程目录中使用`menuconfig`命令开始进行项目配置,如果没有出错接下来就可以看到`menuconfig`的界面了,如下图:

![image](./figures/menuconfig_window.png)

使用`menuconfig`命令打开配置图形界面来配置rt-thread,可以在界面中可以看到和RT-Thread相关的配置项。

选择好配置项之后按ESC键退出,选择保存修改即可自动生成rtconfig.h文件。

如果修改了`RT-Thread online packages`内的选项,想要下载在线组件包,可以使用`pkgs --update`命令来下载或者更新设置。



#### 第四步:开始编译工程吧

env也携带了`Python & scons`环境,只需在`rt-thread\bsp\stm32f429-apollo` 目录中运行:

scons
即可使用默认的ARM_GCC工具链编译RT-Thread了,scons操作和常规使用方法是相同的。

### 3.2 常见错误提示

#### 常见错误1
Expand Down

0 comments on commit 7a3a6bb

Please sign in to comment.