esp-idf 安装(Windows )

esp32的开发有两种环境,分别是 Arduino 和 esp32-idf。
Arduino 是在 esp32-idf 基础上进行封装的,虽然使用起来比较方便,但是能自由更改的就变少了,适合新手使用。
esp32-idf 开发难度会大一些,但是可操作空间也会大一些。

一、准备材料

二、esp-idf安装

esp-idf安装有两种方式,分别是手动安装和 esp-idf 安装工具安装。
以前还没有 esp-idf 安装工具时,在Windows环境下安装就会异常困难,但是现在推荐使用 esp-idf 安装工具安装,将会异常简单。

2.1 esp-idf工具安装器

  1. 下载esp-idf工具安装器

  2. 根据需要选择安装包,因为我不使用乐鑫的idf编辑器,所以我下载了最新的idf

  3. 双击安装包

  4. 选择语言

  5. 同意协议

  6. 检查安装环境

  7. 设置工具的安装路径

  8. 选择需要安装的组件

  9. 安装

  10. 安装完成

2.2 esp-idf 手动安装

  1. 获取 esp-idf
    GitHub:https://github.com/espressif/esp-idf

    git clone -b v4.4.2 --recursive https://github.com/espressif/esp-idf.git
    

    注意:
    git clone 命令的 -b v4.4.2 克隆版本对应的分支。
    --recursive 是循环克隆git子项目,如果克隆时没有使用 --recursive 进行循环克隆,可以使用git submodule update --init命令获取所有子模块

    cd esp-idf
    git submodule update --init
    
  2. Cmake 安装
    详细安装见:https://www.cnblogs.com/jzcn/p/16733956.html

  3. Ninja/idf.py 安装
    详细安装见:Ninja安装:https://www.jianshu.com/p/2f93fd6a64c9
    注意:Ninja目前只支持64位的系统,如果是32位的系统只能使用idf.py

  4. Python 安装
    详细安装见:https://www.cnblogs.com/jzcn/p/16733969.html
    Python 安装完成后,从 Windows 中打开“命令提示符”窗口,并运行以下命令:

    pip install --user pyserial
    
  5. 工具链下载
    下载地址:https://dl.espressif.com/dl/xtensa-esp32-elf-gcc8_4_0-esp-2021r2-patch3-win32.zip

  6. 完成
    到此环境需要的工具基本就安装完成了,对于不熟悉这些工具的朋友来说还是比较麻烦的,在esp-idf也写了自动安装的脚本,详细见2.3

2.3 esp-idf 脚本安装

  1. 下载 esp-idf

    git clone -b v4.4.2 --recursive https://github.com/espressif/esp-idf.git
    

    esp-idf 从GitHub中下载完成后,可以看到其中有 install 和 export 两个文件,如下图所示:

  2. 执行脚本安装
    进入 esp-idf 路径下执行命令

    install.bat esp32s3         # CMD中执行
    ./install.ps1 esp32s3       # Windows PowerShell
    

    注意:
    可以一次安装多个目标,如./install.sh esp32,esp32c3,esp32s3
    安装的工具默认路径是 %USERPROFILE%\.espressif, 想要更改安装位置,请在执行命令前将自己需要安装的路径设置环境,变量名为 IDF_TOOLS_PATH

  3. 配置环境变量
    在 esp-idf 路径下执行命令

    export.bat         # CMD中执行
    ./export.ps1       # Windows PowerShell
    

注意:手动安装时,下载的工具多数时GitHub中下载的,所以还是建议采用离线安装的方式比较快

三、创建项目

案例程序在esp-idf/examples的路径下,可以直接将 examples 目录下的 get-started/hello_world 工程拷贝找指定目录进行测试,也可以使用命令进行拷贝,

xcopy /e /i %IDF_PATH%\examples\get-started\hello_world hello_world

注意: ESP-IDF 编译系统不支持带有空格的路径。

四、测试

打开 ESP-IDF 4.4 CMDESP-IDF 4.4 PowerShell进入项目目录,执行下面命令

  1. 配置开发板信息

    idf.py set-target esp32s3
    
  2. 编译工程
    在项目主路径下执行下面命令

    idf.py build
    
  3. 下载

    idf.py -p PORT [-b BAUD] flash
    

    idf.py -p PORT COM7 flash

  4. 打开串口显示窗口

    idf.py -p PORT monitor
    

    注意:运行idf.py -p PORT flash monitor命令,可以一次性执行构建、烧录和监视过程。

五、使用技巧

  1. 配置 esp32 信息
    配置 esp32 相关信息可以直接打开项目中的sdkconfig文件直接配置,如下图所示:

    当然也可以通过图形界面进行配置

    idf.py menuconfig
    

    **注意这个图形配置界面在CMD中可能不能正常运行,换用 PowerShell 即可

  2. 在 CMD 或 PowerShell 中使用 idf.py 命令
    当打开 CMD 或 PowerShell 时,窗口会自动添加一些路径,如下图所示:

    从图中可以看出,只需要将这些路径添加到环境变量中即可。

六、问题

  1. 执行策略问题

    解决办法:
    以管理员身份打开 PowerShell 执行下面命令
    get-executionpolicy
    set-executionpolicy remotesigned
    

参考文献

Ninja安装:https://www.jianshu.com/p/2f93fd6a64c9

posted @ 2022-09-28 08:28  浇筑菜鸟  阅读(4796)  评论(7编辑  收藏  举报