文稿教程成果

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

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

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

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

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

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

7、供了軟件包的能。、更新、刪除等管理功輸入pkgs 可以看到如下命令簡介：.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 中 開啟 你想要操作的軟件包這些軟件包位于分類：菜單下，進(jìn)入該菜單后，則可以看如下軟件包RTThreadonlinepackages找到你需要的軟件包然后選中開啟，保存并config 。此時軟件包已被標(biāo)記選中，但是還沒有到本地，所以還無法使用。：如果軟件包在本地已被選中

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

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

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

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

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