文稿教程成果

1、RT-Thread env 工具使用手冊(cè)1. 介紹env 是 RT-Thread 推出的開(kāi)發(fā)輔助工具，基于 RT-Thread 操作系統(tǒng)的項(xiàng)目工程，提供編譯構(gòu)建環(huán)境、圖形化系統(tǒng)配置及軟件包管理功能。其內(nèi)置的config 提供了簡(jiǎn)單易用的配置剪裁工具，可對(duì)內(nèi)核、組件和軟件包進(jìn)行自由裁剪，使系統(tǒng)以搭積木的方式進(jìn)行構(gòu)建。1.1 主要特性config 圖形化配置界面，交互性好，操作邏輯強(qiáng)；豐富的文字幫助說(shuō)明，配置無(wú)需查閱文檔； 使用靈活，自動(dòng)處理依賴，功能開(kāi)關(guān)徹底； 自動(dòng)生成 rtconfig.h，無(wú)需手動(dòng)修改；使用 scons 工具生成工程，提供編譯環(huán)境，操作簡(jiǎn)單；提供多種軟件包，模塊化軟件包耦合關(guān)

2、聯(lián)少，可維護(hù)性好；軟件包可，軟件包持續(xù)集成，包可靠性高；1.2 準(zhǔn)備工作env 工具包含了 RT-Thread 源代碼開(kāi)發(fā)編譯環(huán)境和軟件包管理系統(tǒng)。在電腦上裝好 git，git 的地址為 ，根據(jù)向?qū)д_安裝 git，并將 git 添加到系統(tǒng)環(huán)境變量。軟件包管理功能需要 git 的支持。注意在工作環(huán)境中，所有的路徑都不可以有中文字符或者空格。2. env 的使用方法2.1 打開(kāi) env臺(tái)RT-Thread 軟件包環(huán)境主要以命令行臺(tái)為主，同時(shí)以字符型界面來(lái)進(jìn)行輔助，使得盡量減少修改配置文件的方式即可搭建好 RT-Thread 開(kāi)發(fā)環(huán)境的方式。打開(kāi)env臺(tái)有兩種方式：2.1.1 方法一：點(diǎn)擊 env

3、 目錄下可執(zhí)行文件進(jìn)入 env 目錄，可以運(yùn)行本目錄下的 env.exe ，如果打開(kāi)失敗可以嘗試使用 env.bat 。2.1.2 方法二：在文件夾中通過(guò)右鍵菜單打開(kāi) env臺(tái)env 目錄下有一張 Add_Env_To_Right click_.png (添加 env 至右鍵菜單.png) 的圖片，根據(jù)圖片上的步驟操作，就可以在任意文件夾下通過(guò)右鍵菜單來(lái)啟動(dòng) env如下：臺(tái)。效果2.2 編譯 bsp注意事項(xiàng)：因?yàn)樾枰O(shè)置 env 進(jìn)程的環(huán)境變量，第一次啟動(dòng)可能會(huì)出現(xiàn)殺毒軟件誤報(bào)的情況，如果遇到了 殺毒軟件誤報(bào) ，env 相關(guān)程序運(yùn)行，然后將相關(guān)程序添加至白即可。scons 是 RT-Threa

4、d 使用的編譯構(gòu)建工具，可以使用 scons 相關(guān)命令來(lái)編譯 RT-Thread 。第一步：切換到 bsp 根目錄打開(kāi)臺(tái)后，可以在命令行模式下使用 cd 命令切換到你想要配置的 bsp 根目錄中。例如工程目錄為:：rtthreadbspstm32f429apollo第二步：bsp 的編譯env 中攜帶了Python & scons 環(huán)境，只需在 rt threadbspstm32f429apollo 目錄中運(yùn)行 scons 命令即可根據(jù) rtconfig.h 中的配置使用默認(rèn)的 ARM_GCC 工具鏈編譯 bsp。編譯：如果使用 mdk/iar 來(lái)進(jìn)行項(xiàng)目開(kāi)發(fā)，可以直接使用 bsp 中

5、的工程文件或者使用以下命令中的其中一種，重新生成工程，再進(jìn)行編譯。.2.3.sconsscons sconstarget=iartarget=mdk4 target=mdk5scons，請(qǐng)參考文檔中的 scons2.3 bsp 配置：configconfig 是一種圖形化配置工具，RT-Thread 使用其對(duì)整個(gè)系統(tǒng)進(jìn)行配置、裁剪。2.3.1 快捷鍵介紹進(jìn)入 bsp 根目錄，輸入所示：config 命令后即可打開(kāi)其界面。config 常用快捷鍵如圖2.3.2 修改配置config 有多種類型的配置項(xiàng)，修改方法也有所不同，常見(jiàn)類型如下：開(kāi)/關(guān) 型：使用空格鍵來(lái)選中或者關(guān)閉數(shù)值、字符串型：按下回車

6、鍵后會(huì)出現(xiàn)2.3.3 保存配置框，在框中對(duì)配置項(xiàng)進(jìn)行修改選擇好配置項(xiàng)之后按 ESC 鍵，選擇保存修改即可自動(dòng)生成 rtconfig.h 文件。此時(shí)再次使用 scons 命令就會(huì)根據(jù)新的 rtconfig.h 文件重新編譯工程了。2.4 軟件包管理：packageRT-Thread 提供一個(gè)軟件包管理平臺(tái)，這里存放了提供或開(kāi)發(fā)者提供的軟件包。該平臺(tái)為開(kāi)發(fā)者提供了眾多可重用軟件包的選擇，這也是 RT-Thread的重要組成部分。點(diǎn)擊這里 可以查看到 RT-Thread及使用示例。的提供的軟件包，絕大多數(shù)軟件包都有詳細(xì)的說(shuō)明文檔2.4.1 簡(jiǎn)介package 工具作為 env 的組成部分，為開(kāi)發(fā)者提

7、供了軟件包的能。、更新、刪除等管理功輸入pkgs 可以看到如下命令簡(jiǎn)介：.2.3.4.5.6.7.$ pkgsusage: env.py package h update list printenvwizard upgradeoptional arguments:h,helpshow thishelp message and exitupdateinupdate packages, install or remove the packages as you set8.9.0.2.configlist target packagescreate a package with wizardupda

8、te local packages list from git repo print environmental variables to checklist wizard upgradeprintenv截止到 2018-03-13 ，當(dāng)前軟件包數(shù)量達(dá)到 40+2.4.2在、更新、刪除軟件包、更新軟件包前，需要先在config 中 開(kāi)啟 你想要操作的軟件包這些軟件包位于分類：菜單下，進(jìn)入該菜單后，則可以看如下軟件包RTThreadonlinepackages找到你需要的軟件包然后選中開(kāi)啟，保存并config 。此時(shí)軟件包已被標(biāo)記選中，但是還沒(méi)有到本地，所以還無(wú)法使用。：如果軟件包在本地已被選中

9、，但是未，此時(shí)輸入： pkgsupdate ，該軟件包自動(dòng)；更新 ：如果選中的軟件包在服務(wù)器端有更新，并且版本號(hào)選擇的是 latest 。此時(shí)輸入：update ，該軟件包將會(huì)在本地進(jìn)行更新；pkgs刪除 ：某個(gè)軟件包如果無(wú)需使用，需要先在config 中取消其的選中狀態(tài)，然后再執(zhí)行： pkgsupdate 。此時(shí)本地已但未被選中的軟件包將會(huì)被刪除。2.4.3 升級(jí)本地軟件包信息隨著 package 系統(tǒng)的不斷壯大，會(huì)有越來(lái)越多的軟件包加入進(jìn)來(lái)，所以本地看到config 中的軟件包列表可能會(huì)與服務(wù)器 不同步 。使用 pkgsupgrade 命令即可解決該問(wèn)題，這個(gè)命令不僅會(huì)對(duì)本地的包信息進(jìn)行更

10、新同步，還會(huì)對(duì)env的功能議定期使用。進(jìn)行升級(jí)，建2.5 env 工具配置新版本的 env 工具中加入了自動(dòng)更新軟件包和自動(dòng)生成 mdk/iar 工程的選項(xiàng)，默認(rèn)是不開(kāi)啟的?？梢允褂胹etting 命令來(lái)進(jìn)行配置。configs/使用s 命令進(jìn)入 env 配置界面config如果選中了 auto update pkgs config 那么會(huì)在使用config功能后自動(dòng)使用 pkgsupdate 命令來(lái)并安裝軟件包，同時(shí)刪除舊的軟件包。本功能在軟件包時(shí)使用。如果選中了 auto create a mdk/iar project ，那么在config 界面之后就會(huì)自動(dòng)生成一個(gè)你選中類型的工程。這個(gè)

11、功能是為了方便的生成 mdk/iar 工程而使用的，無(wú)需多次使用 scons 命令來(lái)生成 mdk/iar 工程。3. 應(yīng)用：在項(xiàng)目中使用 env3.1 使用 env 的要求config 是 RT-Thread 3.0 以上版本的特薦將 RT-Thread 更新到 3.0 以上版本。目前 RT-Thread 還沒(méi)有對(duì)所有的 bsp 做config 的支持，也就是說(shuō)有些 bsp 暫時(shí)還不能使用config 來(lái)進(jìn)行配置，但常用的 bsp 都已經(jīng)支持。3.2config 中選項(xiàng)的修改方法如果想在config 的配置項(xiàng)中添加宏定義，則可以修改 bsp 下的 Kconfig 文件，修改方法可以在網(wǎng)絡(luò)中搜索

12、 Kconfig語(yǔ)法 關(guān)鍵字獲得詳細(xì)的說(shuō)明文檔，也可以參考 RT-Thread 中的Kconfig 文件或者已經(jīng)支持過(guò)config 的 bsp 中的 Kconfig 文件。3.3 新的項(xiàng)目添加config 功能這里的新項(xiàng)目指的是，還未生成 .config 和 rtconfig.h 的全新開(kāi)發(fā)的項(xiàng)目。因?yàn)檫@兩個(gè)文件，只有在config 第一次保存創(chuàng)建。具體流程如下：1.2.將已經(jīng)支持config 功能的 bsp 里面的 kconfig 文件拷貝到新的項(xiàng)目根目錄中。注意修改 Kconfig 中的 RTT_ROOT 值為 RT-Thread 所在目錄，否則可能提示找不到RTT_ROOT 。3.使用c

13、onfig 命令開(kāi)始配置即可。3.4 舊項(xiàng)目添加config 功能這里的舊項(xiàng)目指的是已經(jīng)經(jīng)過(guò)一段時(shí)間的開(kāi)發(fā)，而且項(xiàng)目中存在已經(jīng)修改過(guò)的 rtconfig.h文件，但是沒(méi)有使用過(guò)config 來(lái)配置的項(xiàng)目。具體流程如下：1.2.首先備份舊項(xiàng)目?jī)?nèi)的 rtconfig.h 文件。使用 sconsgenconfig 命令根據(jù)已有的 rtconfig.h 生成 .config 文件，這里生成的.config 文件保存了舊項(xiàng)目中 rtconfig.h 文件對(duì)項(xiàng)目的配置參數(shù)。3.將已經(jīng)支持中。config 功能的 bsp 里面的 kconfig 文件拷貝到要修改項(xiàng)目的根目錄4.注意修改 Kconfig 中的 RTT_ROOT 值為