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,注意串口号需要根据开发板连接电脑后在，电脑设备管理器中查到当前设备的串口号填进去