使用一鍵安裝工具快速搭建 ESP-IDF 開發(fā)環(huán)境 (Windows)
我們收到用戶對(duì) ESP-IDF SDK 軟件開發(fā)環(huán)境感到搭建難、門檻高的反饋。為解決用戶在此方面的問(wèn)題。為此,我們推出本期教程介紹在 Windows 操作系統(tǒng)下使用一鍵安裝工具快速搭建 ESP-IDF 開發(fā)環(huán)境。
您可以觀看教程視頻,也可以閱讀接下來(lái)本篇的圖文教程。
本篇教程分為以下三個(gè)部分:
Part 1:使用一鍵安裝工具快速搭建 ESP-IDF SDK 軟件編譯環(huán)境——Windows
Part 2:使用 ESP-IDF CMD 命令行終端編譯 SDK 例程——ESP-loT-Bridge
Part 3:使用 VS Code 編寫 SDK 代碼或進(jìn)行二次開發(fā)
提示:推薦使用系統(tǒng):64 bit Windows 10 及以上。
在進(jìn)行開發(fā)環(huán)境搭建時(shí)請(qǐng)暫時(shí)關(guān)閉電腦端殺毒軟件避免誤刪文件。

Part 1:使用一鍵安裝工具快速搭建 ESP-IDF SDK 軟件編譯環(huán)境——Windows
1.?下載 ESP-IDF 工具安裝器
首先我們需要訪問(wèn)樂(lè)鑫官網(wǎng),在支持——技術(shù)文檔中搜索“編程指南”,找到“ESP-IDF 編程指南”。ESP-IDF 編程指南中的快速入門章節(jié)是對(duì)快速搭建 ESP-IDF 開發(fā)環(huán)境的介紹,在這里我們可以找到 ESP-IDF 的安裝說(shuō)明 “Windows Installer”。?

在跳轉(zhuǎn)后的頁(yè)面找到 ESP-IDF 工具安裝器,并點(diǎn)擊下載鏈接進(jìn)行下載。?

您也可以直接點(diǎn)擊此鏈接下載 ESP-IDF 工具安裝器:ESP-IDF?工具安裝器。
跳轉(zhuǎn)成功后可以看到 ESP-IDF 的在線版本和離線版本安裝包。?

對(duì)于選擇何種版本的安裝包,我們有如下建議:
如使用?Release?版本或?Master?版本的?ESP-IDF?SDK?軟件開發(fā)環(huán)境,需要使用在線安裝包。
使用在線安裝包安裝時(shí),建議電腦連接有線網(wǎng)絡(luò)加快網(wǎng)速。
國(guó)內(nèi)用戶如訪問(wèn) Github 有困難,建議勾選 Gitee 鏡像。?

如需使用?Tag?版本的?ESP-IDF?SDK?軟件開發(fā)環(huán)境,建議使用離線安裝包。
離線安裝程序不需要任何網(wǎng)絡(luò)連接,且安裝程序中包含了 Python、Git、交叉編譯器、CMake 和 Ninja 構(gòu)建工具等所有需要的依賴文件,這些都是 ESP-IDF 中構(gòu)建固件的必備工具,因此我們更推薦剛?cè)腴T的用戶使用離線安裝程序。
ESP-IDF?SDK 軟件環(huán)境適配所有樂(lè)鑫 ESP32 系列的產(chǎn)品,但不同系列的 ESP32 產(chǎn)品要求的 ESP-IDF?SDK?版本不同,具體對(duì)應(yīng)的版本可以在官網(wǎng)的?ESP-IDF?SDK?軟件發(fā)布說(shuō)明中查看。
此處需要注意:
如果需要使用 ESP32-C6 或 ESP32-H2 系列產(chǎn)品,目前需要在選擇 ESP-IDF 版本中選擇 Master 版本的 SDK。
如無(wú)特殊需求,我們推薦使用最新 Tag 或?Release?版本的?SDK。
此外,ESP-IDF 的開發(fā)工作流程和不同版本的具體區(qū)別,可以查看?ESP-IDF 版本簡(jiǎn)介。
本教程中選用的是離線版本安裝包演示安裝 ESP-IDF Tag v5.0 版本的軟件編譯環(huán)境。
2.?安裝 ESP-IDF 軟件編譯環(huán)境
首先,點(diǎn)擊運(yùn)行安裝包并選擇語(yǔ)言環(huán)境。?

勾選同意此協(xié)議,進(jìn)入下一步。?

等待系統(tǒng)檢查完成,繼續(xù)下一步。?

選擇 ESP-IDF 編譯工具安裝的路徑,再點(diǎn)擊下一步。?

在配置界面中,可以為 ESP 系列的產(chǎn)品選擇安裝串口驅(qū)動(dòng)和 USB 驅(qū)動(dòng),還可以勾選需要的產(chǎn)品系列。設(shè)置完成后,進(jìn)入下一步。?

檢查安裝路徑,點(diǎn)擊安裝完成。此處大約需要等待 4 分鐘。?

安裝完成后,桌面上生成了 ESP-IDF CMD 終端,打開終端,當(dāng)終端成功打印了“idf.py build”指令時(shí),說(shuō)明我們的環(huán)境已經(jīng)安裝成功了。?

3.?同一?Windows?環(huán)境下同時(shí)運(yùn)行多個(gè)版本的 SDK 軟件編譯環(huán)境
我們注意到大家會(huì)對(duì)“同一?Windows 環(huán)境下是否支持多個(gè)版本的 SDK 軟件編譯環(huán)境”存在疑惑。事實(shí)上,多個(gè)版本的 SDK 可以在同一 Windows 環(huán)境下同時(shí)存在。
我們運(yùn)行“idf.py build”指令在兩個(gè)不同環(huán)境的終端內(nèi)進(jìn)行代碼編譯,可以看到當(dāng)我們使用不同版本的 SDK CMD 終端編譯環(huán)境編譯例程時(shí),可以各自獨(dú)立編譯成功,不受任何限制,不會(huì)相互干擾。編譯完成后會(huì)打印日志,日志中顯示當(dāng)前編譯工程生成的固件以及對(duì)應(yīng)固件的下載地址,并提示我們使用“idf.py -p (PORT) flash”指令來(lái)燒錄固件。?

如果想要切換芯片的環(huán)境,我們可以運(yùn)行 target 指令,如:“idf.py set-target esp32s3”,其中 S3 為具體的芯片環(huán)境。切換芯片環(huán)境后,我們?cè)賹?duì)例程重新進(jìn)行編譯,即可看到芯片環(huán)境已經(jīng)切換成功了。?

到這里為止,在 Windows?環(huán)境下使用一鍵安裝工具快速搭建?ESP-IDF?SDK?軟件編譯環(huán)境已經(jīng)完成了。
Part 2:使用 ESP-IDF CMD 命令行終端編譯 SDK 例程——ESP-loT-Bridge
接下來(lái)我們將為大家演示使用 ESP-IDF CMD 軟件編譯環(huán)境來(lái)編譯樂(lè)鑫其他應(yīng)用方案的 SDK 例程,此處演示的是 ESP-IoT-Bridge 網(wǎng)關(guān)方案 SDK 的軟件編譯。
我們可以借助 ESP-IDF CMD 的終端環(huán)境先來(lái)克隆所需要的 SDK 源碼。進(jìn)入到上層目錄,將所有待克隆的 SDK 都放到 ESP 目錄下,我們?cè)?SDK 的目錄下獲取克隆的鏈接:https://github.com/espressif/esp-iot-bridge.git?
這里我們克隆 Master 版本的 ESP-IoT-Bridge SDK。如果我們需要某個(gè)特定版本的 SDK,只需要在克隆指令增加 -b branch(branch 為具體的版本號(hào))來(lái)指定克隆特定版本的 SDK。?

SDK 克隆完成后,還需要克隆 SDK 對(duì)應(yīng)的子倉(cāng)庫(kù):?
運(yùn)行“git submodule update --init —recursive”指令來(lái)克隆子倉(cāng)庫(kù)
運(yùn)行“git pull”指令,確認(rèn)當(dāng)前是最新的 SDK

然后我們需要檢查 ESP-IoT-Bridge SDK 支持的 IDF 版本號(hào),可以看到目前已經(jīng)適配 IDF Release v5.0 版本。?

接下來(lái)測(cè)試對(duì)應(yīng) SDK 的例程。運(yùn)行“dir”指令可以查看當(dāng)前的目錄。

?我們使用 cd 指令進(jìn)入到例程的目錄下,然后使用“idf.py build”指令編譯例程。?

現(xiàn)在可以看到,我們使用 ESP-IDF v5.0 版本的 CMD 終端環(huán)境編譯 ESP-IoT-Bridge 下的例程已經(jīng)編譯成功。編譯完成的日志中會(huì)顯示當(dāng)前編譯工程生成的固件以及對(duì)應(yīng)固件的下載地址。?

同樣,ESP-IoT-Solution、ESP-Mesh-Lite 等其他 SDK 例程編譯與上述操作步驟相同。
Part 3:使用 VS Code 編寫 SDK 代碼或進(jìn)行二次開發(fā)
如果用戶需要基于 SDK 里的例程進(jìn)行二次開發(fā),我們可以在“ESP-IDF CMD”終端運(yùn)行“code .”命令,使用 VS Code 代碼編輯環(huán)境打開我們的 SDK 進(jìn)行代碼編寫和二次開發(fā)。

我們推薦使用「ESP-IDF CMD 工程編譯環(huán)境 + VS Code 代碼編輯器」,它有以下幾個(gè)優(yōu)勢(shì):
便于版本維護(hù)、更新和管理?
支持便捷切換不同芯片的軟件環(huán)境
支持編譯樂(lè)鑫發(fā)布的其他應(yīng)用解決方案的 SDK 例程。
以上就是本期教學(xué)的全部?jī)?nèi)容,本期教學(xué)中涉及的資源可參考下方相關(guān)鏈接自行獲取。如果您有任何問(wèn)題,可以到樂(lè)鑫官網(wǎng)查看相關(guān)技術(shù)文檔獲取幫助,歡迎在評(píng)論區(qū)留言討論,或隨時(shí)聯(lián)系我們。

相關(guān)鏈接
ESP-IDF 編程指南
https://docs.espressif.com/projects/esp-idf/zh_CN/release-v5.0/esp32/get-started/index.html
VS Code
https://code.visualstudio.com/
Windows Installer
https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32h2/get-started/index.html#id7
切換芯片環(huán)境——文檔說(shuō)明
https://docs.espressif.com/projects/esp-idf/zh_CN/release-v5.0/esp32s3/get-started/windows-setup.html#id10
ESP-IDF 工具安裝器下載(離線版本 & 在線版本)
https://dl.espressif.com/dl/esp-idf/?idf=4.4
ESP-IDF?SDK?軟件發(fā)布說(shuō)明
https://github.com/espressif/esp-idf/blob/master/README_CN.md
ESP-IoT-Bridge SDK
https://github.com/espressif/esp-iot-bridge/blob/master/README_CN.md
樂(lè)鑫其他應(yīng)用方案的 SDK
https://github.com/espressif
ESP-IDF 版本簡(jiǎn)介
https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/versions.html
樂(lè)鑫官網(wǎng)
https://www.espressif.com/
聯(lián)系我們
https://www.espressif.com/zh-hans/contact-us/sales-questions