ESP32-IDF安裝並在VSCode上編譯Hello World

ESP32-IDF安裝

准備工作

1. 安裝python 3
   • 安裝方法參考鏈接：https://blog.csdn.net/hg_qry/article/details/106415252
2. 安裝git
   • 安裝方法參考鏈接：https://blog.csdn.net/qq_25003027/article/details/108252324

一、在gitee上下載想要安裝的idf版本

• 使用git bash端下載，指令如下：
  • git clone -b [tags標簽/分支名稱] [git地址]
    例如：git clone -b release/v4.3 https://gitee.com/EspressifSystems/esp-idf.git
    下載好后會在git clone指定的下載路徑有個esp-idf的文件夾

二、在gitee上下載esp-gitee-tools工具

• 使用git bash端下載，指令如下：
  • gitee倉庫鏈接：https://gitee.com/EspressifSystems/esp-gitee-tools
    例如：git clone https://gitee.com/EspressifSystems/esp-gitee-tools.git
    下載好后會在git clone指定的下載路徑有個esp-gitee-tools的文件夾

三、在git bash端下載idf編譯工具和組件更新具體步驟

1. 打開esp-idf文件夾
   cd esp-idf
2. 添加編輯組件的環境變量(安裝位置),具體位置自行定義，不定義可能會默認下載到C盤
   export IDF_TOOLS_PATH='D:\_software_\esp\esp-idf-v4.3\.espressif'
3. 在esp-idf文件夾位置執行esp-gitee-tools文件夾中的install.sh指令下載idf相關的編譯工具（具體位置自行定義）
   ../../esp-gitee-tools/install.sh
4. 在esp-idf文件夾位置執行esp-gitee-tools文件夾中的submodule-update.sh指令更新組件（具體位置自行定義）
   ../../esp-gitee-tools/submodule-update.sh

至此，完成以上步驟后就可以成功安裝好esp32 idf包以及相關編譯環境，可以編譯個Hello World耍了。

---

配置使用VSCode運行idf編譯環境

一、vscode 的 powershell 的 $PROFILE 文件對應修改

1. 打開vscode終端(快捷鍵Ctrl+`),運行以下指令:
   $PROFILE
   運行指令后命令框會輸出：C:\Users\why\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1，如果在該路徑下沒有這個腳本文件需要自行新建一個。
2. 打開該腳本文件中並添加以下代碼

   function esp_init{
   		$env:IDF_TOOLS_PATH="F:\esp\esp-idf-v4.3.1\.espressif"
   		. F:\esp\esp-idf-v4.3.1\esp-idf\export.ps1
   		} 
   

   • 指令解析：
     1. $env:IDF_TOOLS_PATH="F:\esp\esp-idf-v4.3.1.espressif"為加載idf編譯工具地址到環境變量中。具體路徑自行定義
     2. . F:\esp\esp-idf-v4.3.1\esp-idf\export.ps1，因為剛剛安裝的工具尚未添加至 PATH 環境變量，無法通過“命令窗口”使用這些工具。因此，必須設置一些環境變量。

二、允許PowerShell執行腳本

• 管理員身份運行PowerShell
  • 輸入命令 Set-ExecutionPolicy RemoteSigned
    • 允許（Yes）

完成以上所有操作后就全部弄完編譯idf的准備工作了。以后只需要在vscode中打開esp32 idf的工程后打開vscode的powershell終端，輸入指令esp_init即可一鍵啟動idf編譯環境。

---

開始創建工程，運行hello world

一、獲取hello world工程

可以從 ESP-IDF 中 examples 目錄下的 get-started/hello_world 工程復制出來到你想放的路徑。

二、使用VSCode打開該文件夾

在VSCode中點擊文件->打開文件夾，或者使用快捷鍵先ctrl+k再ctrl+o

三、打開VSCode的PowerShell終端

在VSCode中點擊終端->新的終端，或者使用快捷鍵先ctrl+`

四、運行我們之前寫好的一鍵idf編譯環境加載腳本

powershell終端，輸入指令esp_init即可一鍵啟動idf編譯環境

五、編譯hello world工程

運行idf的編譯腳本。idf.py build或者idf.py all即可開始編譯工程

六、下載到esp32開發板

運行idf的燒錄腳本。idf.py -p COM5 flash,注意串口號需要根據開發板連接電腦后在，電腦設備管理器中查到當前設備的串口號填進去