1.安裝編譯工具鏈ESP-IDF
三種安裝方式:
- 官方在線安裝包(不推薦,因默認在桌面創建安裝路徑,個人不喜歡,應該可以手動設置,但懶得花時間深究)。
- 官方離線安裝包(推薦)。
- 使用
VSCode安裝(不推薦,基於中國的網絡環境,因網絡無響應安裝失敗概率99%或更高🤬,用這種方式最后大概率你會罵罵咧咧的找別的安裝方式)。
2.安裝ESP-IDF插件
在VSCode里面搜索ESP-IDF插件並安裝,安裝完成后點擊插件圖標,需要初始化設置,選擇本地安裝好的ESP-IDF即可,不用在重新下載安裝了。
3.新建項目
新建項目文件夾HelloWorld(可自定義)並創建文件CMakeLists.txt添加內容:
# The following lines of boilerplate have to be in your project's
# CMakeLists in this exact order for cmake to work correctly
cmake_minimum_required(VERSION 3.5)
include($ENV{IDF_PATH}/tools/cmake/project.cmake)
project(HelloWorld)
此處的CMakeLists.txt為項目文件,project(HelloWorld) 指定了項目名稱。
建議參考安裝好的ESP-IDF目錄下的示例項目,可能版本不同,內容會有所變動。
4.源碼
在項目文件夾下 新建源碼文件夾main(可自定義)並創建文件CMakeLists.txt添加內容:
idf_component_register(SRCS "Main.c"
INCLUDE_DIRS "")
此處的CMakeLists.txt為源碼組織結構配置文件,編譯器會根據該配置查找並鏈接源碼文件,其中的Main.c(可以自定義)即為新建的源碼文件。
5.主函數
在Main.c中添加主函數
#include <stdio.h>
void app_main()
{
printf("Hello World!\n");
}
PS:為啥是void app_main()而不是void main()🤨,可能芯片內部或者編譯后的bin會生成void main()吧,設計者 暴露出void app_main()是為了我們更加方便開發應用業務。
6.設置目標芯片
VSCode按F1輸入device,從結果列表中選擇ESP-IDF:Device Configuration
設置芯片之后,IDF插件會自動在 項目文件夾HelloWorld下生成sdkconfig文件,該文件即為目標芯片相關的API接口和一些其他配置。
7.編譯、下載、監視程序運行情況
點擊VSCode左下角相應的菜單即可執行 編譯、下載、監視運行等,鼠標移動到按鈕上可顯示菜單功能,如果VSCode左下角沒有顯示這一排菜單,點擊左側IDF插件圖標即可。
溫馨提示:在切換芯片之后記得點擊 清理 菜單(上面垃圾桶圖標),否則可能會編譯失敗。
8.干掉#include波浪線提示
點擊黃色小燈泡,點擊編輯"includePath"設置
在高級設置--瀏覽:路徑下添加:
${workspaceFolder}
D:/VSCode/Cache/esp-idf/components
D:/VSCode/Cache/.espressif
其中第1行為項目源碼路徑,第2,3行為ESP-IDF安裝路徑,注意使用左斜線
然后點擊下面的勾選
回到源碼波浪線處,點擊小燈泡,點擊添加到***即可修復。
9.注意
- 源碼文件夾名稱字母必須小寫,否則編譯可能會出現找不到***的錯誤
- 建議參考安裝好的ESP-IDF目錄下的示例項目,可能版本不同,CMakeLists.txt 內容會有所變動
- 修正錯誤后仍然編譯失敗,可嘗試點擊 清理 菜單(上面垃圾桶圖標),然后再執行編譯
