1. 搭建步驟

以下步驟是以Ubuntu 16.04 LTS 32bit 英文版中為例，其他Linux系統(tǒng)類似，但不排除有小細(xì)節(jié)不同（如包管理軟件為yum等）。

ESP32的下載需要使用USB串口工具，請(qǐng)確保自己的開(kāi)板（ESP-DevkitC、NodeMCU-32S）集成有USB串口功能，或者使用USB轉(zhuǎn)串口工具，Linux中串口的描述符默認(rèn)是/dev/ttyUSB0，如果你使用的串口不是/dev/ttyUSB0，燒寫(xiě)時(shí)修改的路徑請(qǐng)自行修改。

以下示例中l(wèi)inux用戶的名稱為ss，請(qǐng)自行替換為自己linux的用戶名。此外，工程及編譯工具都放在用戶根目錄下，你可以根據(jù)自己實(shí)際情況設(shè)置到合適位置中。

在熊大如下的git項(xiàng)目版本中已經(jīng)經(jīng)過(guò)了測(cè)試，不排除最新版本有了完善：

commit a8504d523214ee872ae480106e31cd1db138b74f

Author: Bernard Xiong

Date: Fri Aug 25 15:29:362017 +0800

1.1. 下載交叉編譯工具

cd ~

wgethttps://dl.espressif.com/dl/xtensa-esp32-elf-linux32-1.22.0-61-gab8375a-5.2.0.tar.gz

1.2. 解壓縮交叉編譯工具

tar -x*** xtensa-esp32-elf-linux32-1.22.0-61-gab8375a-5.2.0.tar.gz

1.3. 安裝必要的軟件

sudo apt-get install git wget make libncurses-devflex bison gperf python python-serial scons

1.4. 獲取代碼

cd ~

git clonehttps://github.com/BernardXiong/rtthread-esp-idf

cd rtthread-esp-idf

git submodule init

git submodule update

cd esp-idf-port/esp-idf

git submodule init

git submodule update

git apply ../0001-cpu_start-patch.patch

git apply ../0002-add-esp_task.h.patch

git apply ../0003-add-memset-to-0.patch

1.5. 修改工程中交叉編譯工具的路徑

修改~/rtthread-esp-idf/rtconfig.py中exec_path的路徑為：

EXEC_PATH =r'/home/ss/xtensa-esp32-elf/bin'

• 注路徑中的ss為linux當(dāng)前用戶的用戶名

1.6. 編譯

首先修改個(gè)Makefile中的一個(gè)小錯(cuò)誤，python那行命令路徑需要修改：

pythonesp-idf-port/esp-idf/components/esptool_py/esptool/esptool.py --chip esp32elf2image --flash_mode "dio" --flash_freq "40m"--flash_size "4MB" -ortthread.bin rtthread-esp32.elf

然后進(jìn)入項(xiàng)目根目錄進(jìn)行編譯

cd ~/rtthread-esp-idf

make all

1.7. 下載

1) 由于Linux下普通用戶無(wú)權(quán)限直接操作/dev/ttyUSB0，首先給當(dāng)前用戶加入相應(yīng)的權(quán)限，以便后邊燒寫(xiě)時(shí)不需要使用sudo權(quán)限：

sudo usermod -aG dialout ss

• 注：ss為linux當(dāng)前用戶的用戶名

設(shè)置完成后注銷(xiāo)重新登錄一下當(dāng)前用戶即可，之后不再需要執(zhí)行該命令。

2) 修改~/rtthread-esp-idf/burn_flash.bat中串口的名字（/dev/ttyUSB0）為如下：

python esp-idf-port/esp-idf/components/esptool_py/esptool/esptool.py--chip esp32 --port /dev/ttyUSB0 --baud 115200 --before"default_reset" --after "hard_reset" write_flash -z--flash_mode "dio" --flash_freq "40m" --flash_size detect0x1000 bootloader.bin 0x10000 rtthread.bin 0x8000 partitions_singleapp.bin

3) 給burn_flash.bat設(shè)置好執(zhí)行權(quán)限：

chmod a+xburn_flash.bat

4) 將開(kāi)發(fā)板與電腦連接好（如果是虛擬機(jī)，需要將設(shè)置連入虛擬機(jī)），同時(shí)如果開(kāi)發(fā)板不支持一鍵燒寫(xiě)功能，一般需要通過(guò)按鍵使其進(jìn)入燒寫(xiě)模式（同時(shí)按下IO0和reset，然后先松開(kāi)reset，再松開(kāi)IO0）；

5) 執(zhí)行一下命令等待燒寫(xiě)完成：

cd ~/rtthread-esp-idf

./burn_flash.bat

（波特率:115200）

2. 其他說(shuō)明

2.1. Linux64bit、Windows及macos的交叉編譯工具

具體見(jiàn)https://github.com/BernardXiong/rtthread-esp-idf，里邊有其他系統(tǒng)交叉編譯工具的下載路徑。

注：windows下需要先安裝MSYS2等GNU-compatible環(huán)境軟件。

2.2. 目錄及文件說(shuō)明

下圖為rttthread-esp-idf的目錄結(jié)構(gòu)：

其中：

• application目錄為rtt應(yīng)用程序的代碼，其中main.c中的app_main()為應(yīng)用程序入口函數(shù)。你可以在這里修改、編碼，來(lái)熟悉和調(diào)試rtt程序。

• build目錄為編譯中間文件使用的目錄，編譯中的.o .d等都在這個(gè)目錄內(nèi)。

• componets目錄為rtt組件代碼保存的目錄，自己編寫(xiě)的組件可以放在這里。

• doc為該項(xiàng)目一些使用、功能的介紹文檔。

• drivers目錄為rtt用于移植驅(qū)動(dòng)的相關(guān)代碼保存的目錄，已有的包括uart、gpio、i2c、psram等。

• esp-idf-port目錄為esp-idf移植修改的代碼目錄，由于rtt on esp32是基于esp官方的esp-idf移植的，esp-idf的代碼及移植補(bǔ)丁等在這個(gè)目錄中。同時(shí)用于下載、打包鏡像等python工具包也在該目錄下。如果你需要更深入地使用ESP32（比如使用自定的分區(qū)結(jié)構(gòu)、使用FlashEncryption等功能），可能需要在這個(gè)目錄配置修改。

• rt-thread為rtt核心的內(nèi)核及相關(guān)組件、驅(qū)動(dòng)等代碼保存的目錄，如果你需要深入了解或調(diào)試rtt核心的功能，可以在本目錄中尋找、修改、調(diào)試。

• 鏡像文件或其輔助文件：

-bootloader.bin：esp32的Second stagebootloader

-partitions_singleapp.bin：esp32的分區(qū)表數(shù)據(jù)，目前rtt默認(rèn)的是非ota的鏡像。

-rttthread-esp32.bin：rtt on esp32的目標(biāo)代碼。

-esp32.common.ld、esp32_out.ld、rtthread-esp32.elf、rtthread-esp32.map：編譯鏡像的中間文件及腳本工具。

• rtconfig.h、rtconfig_project：rtt的配置頭文件。

• sdkconfig.h：esp-idf的配置文件

• rtconfig.py、rtconfig.pyc：rtt編譯的python腳本。

• burn_flash.bat：鏡像燒寫(xiě)腳本。

• Kconfig、Makefile、mkbin.bat、SConscript、SConstruct：項(xiàng)目編譯的各種腳本。

• README.md：項(xiàng)目簡(jiǎn)介。

- End -