ESP32 ESP-IDF开发环境搭建，Windows下基于ESP-IDF | Cmake | VScode插件的 ESP32 开发环境搭建

已于 2022-09-15 15:19:05 修改
阅读量2.5w 收藏 240
点赞数 45
分类专栏： ESP32 文章标签： 嵌入式 esp32 esp-idf 物联网 iot
于 2021-09-07 18:13:19 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Mark_md/article/details/120132945
版权

  之前的一篇博客 Windows上基于ESP-IDF搭建ESP32开发环境 发布后，深受好评。几个月过去了，乐鑫的esp-idf-tools安装工具发生了较大的变化，VsCode插件的功能也愈加完善，在此更新下最新的安装过程。

  同期间，我在ESP32的开发学习过程中（和大家催更的督促下），总结了一套使用方法，并将其汇总为一个开源驱动库 - Easyio，目的是简化ESP-IDF开发框架的使用难度，基本几行代码就可以将一个外设搞定。

  目前已开放预览版本，功能 涵盖GPIO、Key、UART、ADC、DAC、RMT、I2C、SPI、LCD、SDCard、WIFI等驱动。Demo 有诸如 红外遥控、RGB灯带、六轴IMU、TF卡电子相册、MQTT阿里云物联网这些有趣又实用的例程。下一步继续扩充OTA、LVGL、BLE、有线以太网和一些网络通信的Demo，打造一个开发简便且稳定强大的开源库。库的导入方式简便，直接拖入工程的components文件夹下即可使用。并有配套开发板，一板全能，适合与此教程配套使用，详见：Easyio驱动库-Github


  言归正传，限于篇幅，开源驱动库 - Easyio 的使用会在本专栏的其他文章介绍，下面开始正题：Windows下基于 ESP-IDF | Cmake | VScode插件的 ESP32 开发环境搭建。

  2022年3月更新：强烈建议使用离线版安装，因众所周知的原因，导致部分人访问Github巨慢，在线安装极有可能因下载失败导致安装失败。这里推荐用离线版安装，全程无坑。ESP32c3开发环境搭建 IDF V4.4离线版安装使用

  如选择离线版安装，请访问上面链接，下面的安装过程则不再适用。

一、获取 ESP-IDF 和 esp-idf-tools

  • 获取 ESP-IDF（建议V4.2版本，V4.3版本与我的Easyio驱动库有兼容性问题）：ESP-IDF-Github
  • 下载esp-idf-tools-setup安装工具，此工具是乐鑫专为windows平台下快速安装ESP-IDF而设计：esp-idf-tools工具下载

  乐鑫最新的ESP-IDF版本为 V4.3，但在适配easyio库的过程中，发现很多奇怪现象，不单单是编译不通过的问题，有些能编译但在硬件上运行报错，就很离谱。而这些问题在V4.2上则不存在。鉴于V4.2已经对ESP32提供了足够的支持，V4.3着重添加了ESP32-S2/C3的功能，而自己的easyio库暂时没有兼并ESP32-S2/C3的精力，于是推荐使用V4.2版本。

  我这台电脑之前已经安装了esp-idf-v4.3，再clone V4.2需要存放到不同的路径。
在这里插入图片描述

  先将Python装好，版本3.8及以上。

  勾选最下面的 Add xxx to PATH，安装。
2021020309005317
  更新，这一步也是必须的，不然后面运行Vscode插件可能会报错。

  windows搜索cmd，使用命令行窗口：python.exe -m pip install --upgrade pip
20210203153301216


二、安装 esp-idf-tools-setup

  esp-idf-tools-setup 可以看作是IDE的安装向导，它可以非常方便的安装编译和调试环境，并绑定 ESP-IDF SDK。其也自带了一款深度定制的IDE - ESP-IDF Eclipse，不过在使用上差强人意。我是更喜欢VsCode一些，并且VsCode配合上乐鑫的插件，coding体验一点也不比正经的IDE差。

  • 运行esp-idf-tools-setup安装工具。接受，NEXT。
    在这里插入图片描述

  • 使用本地的ESP-IDF，选择刚刚解压的目录。
    在这里插入图片描述

  • ESP-IDF Tools安装路径，默认 Next。
    注意：如果以前安装了其他版本的ESP-IDF，建议这里手动更改下文件夹路径。
    在这里插入图片描述

  • 默认，下一步，安装。
    在这里插入图片描述
    在这里插入图片描述

  • 等待安装完成。
    在这里插入图片描述

  • 之后ESP-IDF在本地就已经安装好了，桌面上会生成几个快捷方式。

  • 通过这些工具，能够完成对ESP32工程的编辑、编译、调试工作。不过由于ESP-IDF Eclipse体验不佳，下面使用VSCode插件，将VSCode作为ESP32开发的IDE。
    在这里插入图片描述


三、VSCode插件安装

  本来呢，Vscode是不能被叫做IDE的，不过乐鑫提供了一个异常强大的插件…于是就顺理成章的转正了。乐鑫官方提供Vscode插件，一站式安装，直接将Vscode升格为IDE，配合上Vscode原有的插件、主题，coding的过程十分惬意。

  • 打开VSCode，搜索esp-idf，安装插件。
    在这里插入图片描述

  • 插件安装完后，查看 - 命令面板（快捷键Ctrl+Shift+P）。

  • 输入 configure esp-idf extension，点击。
    在这里插入图片描述

  • 选择高级。
    在这里插入图片描述

  • 修改IDF版本，选择刚刚安装的IDF本地目录。

  • 【注意】这里我疏忽了，图中第三个下拉框才是ESP-IDF的路径，也就是之前clone下来的IDF路径。我这里忘记选择D盘的SDK路径了，导致未找到IDF，于是它又在C盘下给我clone了一遍，不过好在最后能正常使用。但因为重新下载SDK，这次的安装时间被拉长了很久。

  • 第三个下拉框选择跟第四个相同的路径。
    在这里插入图片描述

  • 等待安装。
    在这里插入图片描述

  • 安装缺少组件。
    在这里插入图片描述

  • 最终安装成功。
    在这里插入图片描述

四、用VSCode创建ESP32工程

  VSCode插件已经安装好了，下面介绍下功能。

  首先用 Vscode插件，从SDK 的 Demo 模板中创建个新工程。ESP-IDF自带了丰富的Demo，这些都会是以后学习的重要资源。

  • 查看 - 命令面板（快捷键Ctrl+Shift+P）。
  • 输入show examples projects，点击。
    在这里插入图片描述
  • 点击弹出的 Use current ESP-ID，使用本地SDK。
    在这里插入图片描述
  • 最终显示这样的界面。左侧是SDK中的Demo列表，右侧是Demo的功能描述。
  • 点击例程 blink，点击 Create project using example blin。
  • 创建一个最简单的工程blink，作为示例。
    在这里插入图片描述
  • 选择一个文件夹，作为工程的存放路径。
    在这里插入图片描述

  • 之后插件就会以SDK中的blink为模板，自动创建一个新工程。

  • blink.c的功能很简单，配置Pin 5为推挽输出IO，以1s为间隔让灯在亮灭的状态间切换，并用串口打印状态。

  • 留意左下角的图标。从左到右分别是：选择下载端口、设置(插件化的 MenuConfig)、清理工程(clean)、编译(build)、下载(flash)、打开调试终端(monitor)、一键 编译+下载+打开调试终端。
    在这里插入图片描述

  • 左下角是插件提供的一些工具，功能为：
    最后一个像火苗的图标，他的功能是 build + flash + monitor。可以一键完成 编译、下载、打开监视窗口，写完代码自己去喝茶转转，等它自动完成就行。
    在这里插入图片描述

  • 代码内容是让 GPIO Pin 5 来回输出0/1的电平，来控制LED闪烁。

  • 而我电路连接的LED是在别的GPIO上，需要更改输出端口。

  • LED输出端口的更改可以在 blink.c 中，直接修改 BLINK_GPIO 宏定义。

  • 也可通过左下角的 GUI Configuration tool 来配置LED端口，将以前的5改为自己电路的端口。

  • 更改后，点击保存。就可以将这个窗口x掉了。
    在这里插入图片描述

  • 因为我们的硬件平台是ESP32，而ESP-IDF默认编译输出对象就是ESP32，不需要额外更改。

  • 插入开发板，点击左下角的选择端口图标，选择端口。（需要提前安装USB转串口的驱动）
    在这里插入图片描述

  • 再点击最末尾的图标，进行一键 编译、下载、打开监视窗口。
    在这里插入图片描述

  • 运行现象，开发板LED闪烁，终端输出LED亮灭状态。
    在这里插入图片描述

注意

后续、Easyio开源驱动库-使用教程

  我在ESP32的开发学习过程中（和大家催更的督促下），总结了一套使用方法，并将其汇总为一个开源驱动库 - Easyio，目的是简化ESP-IDF开发框架的使用难度，基本几行代码就可以将一个外设搞定。

  目前已开放预览版本，功能 涵盖GPIO、Key、UART、ADC、DAC、RMT、I2C、SPI、LCD、SDCard、WIFI等驱动。Demo 有诸如 红外遥控、RGB灯带、六轴IMU、TF卡电子相册、MQTT阿里云物联网这些有趣又实用的例程。下一步继续扩充OTA、LVGL、BLE、有线以太网和一些网络通信的Demo，打造一个开发简便且稳定强大的开源库。库的导入方式简便，直接拖入工程的components文件夹下即可使用。并有配套开发板，一板全能，适合与此教程配套使用，详见：Easyio驱动库-Github

ESP32开源驱动库Easyio的使用，基于ESP-IDF开发框架，非Arduino


ESP32开发板开源计划

  现已开源一款ESP32物联网开发板，支持WIFI、蓝牙、以太网、RS485、CAN通信。板载6轴IMU、温湿度传感器、38K红外遥控收/发、独立RTC、TF卡座。USB和18650双电源供电，有2.0寸单点电容屏可用，配套各外设驱动和LVGL源码。Github、立创EDA、CSDN全云端同步更新。

  详情可见：

打样免费的时代，速去JLC白嫖PCB。

开源学习交流Q群：827686418
在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

参考资料 在线帮助文档

ESP-IDF 快速入门

ESP-IDF API编程指南

ESP32 硬件设计参考

欢迎点赞、收藏，后续会陆续更新ESP32及Easyio的使用。开发板计划也在进程中，敬请期待。

Mark_md
关注
  • 45
    点赞
  • 踩
  • 240
    收藏
    觉得还不错? 一键收藏
  • 20
    评论
专栏目录
ESP32S2基于VScode环境配置esp-idf插件添加自定义组件例程
02-14
在本教程中，我们将详细讲解如何在VSCode环境中配置ESP-IDF插件，以便为ESP32S2开发项目，并添加自定义组件。 首先，确保你已经安装了VSCode和ESP-IDF开发环境。你可以从官方网站下载最新版本的VSCode，并通过...
ESP32工程模板，基于vscode+esp-idf
08-11
总的来说，这个"ESP32工程模板，基于vscode+esp-idf"提供了一个高效、便捷的开发环境，使得开发者可以专注于功能实现，而不用过多关注底层细节。通过学习和使用这个模板，可以迅速上手ESP32的开发工作，为各种IoT...
快速入门ESP32——开发环境配置Arduino IDE
mucherry的博客
11-09 1万+
带你快速入门ESP32——arduino环境配置
【ESP32开发】——开发环境搭建（VSCode+PlatformIO）
m0_61934621的博客
07-31 6358
本章内容主要介绍ESP32的开发环境搭建（基于VSCode+PlatformIO）的流程与相应的注意事项，避免开发ESP32止于环境搭建！在项目的维护过程中，可以更好地管理和更新代码、调试问题，并且能够快速适应和采用新的功能、库或硬件平台。：VSCode 的代码提示和自动补全功能，以及 PlatformIO 的管理工具，都能帮助你编写规范、格式良好且易于阅读的代码。：Arduino 框架是一种简单、易用的嵌入式开发框架，适用于快速原型开发和小型项目。需要选择对应自己开发的开发板型号。
快速入门ESP32——开发环境配置Arduino IDE_arduino esp32
WJud11的博客
05-15 1157
最近这段时间刚好在捣鼓ESP32，遇到了挺多大大小小的坑，所以我将自己的配置过程和注意要点写出来分享给大家，希望对你们有帮助。自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。深知大多数Java工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。因此收集整理了一份《2024年嵌入式&物联网开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。
ESP32 开发笔记 ESP32开发环境搭建 Windows10 esp-idf-tools-setup安装
cnicfhnui的博客
07-05 7582
一、下载esp-idf-tools-setup 下载网址：https://dl.espressif.com/dl/esp-idf/ 最新的esp-idf-tools-setup版本为2.9，安装程序分在线安装和离线安装，这里强烈建议使用离线安装方式，因为涉及到在线下载一些国外镜像失败的情况。 单击下载离线版本1.6G左右，文件虽然很大，但后期会省很多事情！！~ 二、安装esp-idf-tools-setup 双击下载好的esp-idf-tools-setup-offline-2.9.exe。
ESP32-IDF开发笔记 | 01 - ESP-IDF开发环境搭建（2023.04.08更新）
热门推荐
Mculover666的博客（嵌入式）
05-01 3万+
一、ESP32-C3模组 本想仗剑天涯走四方，奈何没有抢到票，五一假期只能宅咯，it is a sad story~ 刚刚到手一块ESP32-C3F模组开发板，上手体验一把！ ESP32-C3系列WIFI模组是一款高集成度的低功耗 2.4G Wi-Fi和蓝牙系统级芯片(SoC)，搭载 RISC-V 32 位单核处理器，工作频率高达160 MHz，内置安全硬件，支持二次开发。 二、ESP32 C3硬件开发环境准备 搭建过程官方参考文档：快速入门 ESP32-C3 使用Micro USB线连接ESP32
ESP32开发第一章：环境搭建
weixin_59776242的博客
09-16 902
介绍了ESP-IDF开发环境搭建的具体流程以及将其集成到VScode上的步骤和出现的错误与解决方案
ESP-IDF环境安装文件
02-22
ESP-IDF，全称为Espressif IoT Development Framework（Espressif物联网开发框架），是Espressif Systems公司为基于ESP32和ESP8266微控制器的开发提供的一套全面的开源工具集。本压缩包包含ESP-IDF v4.0.1版本，Git ...
esp-idf-v4.4.3
最新发布
05-27
ESP-IDF（Espressif IoT Development Framework）是Espressif Systems公司推出的一个开源框架，用于开发基于ESP32和ESP32-S系列微控制器的物联网应用程序。ESP-IDF v4.4.3 是该框架的一个特定版本，它包含了对ESP32...
ESP32-IDF 开发环境在线安装 2.13版本
03-31
ESP32-IDF 2.13版本的在线安装简化了开发环境的搭建，让开发者能快速投入到ESP32的应用开发中。了解并熟练掌握ESP32-IDF的使用方法，能够极大地提高开发效率，充分发挥ESP32的硬件优势，打造出高效、可靠的物联网...
esp-idf-tools-setup-2.3.exe
08-05
esp-idf-tools-setup-2.3.exe 下载300M，外网不容易下载。放在这里供大家下载。谢谢
esp-idf-tools-setup-2.3
12-25
ESP-IDF工具链安装包
esp32 windows环境搭建
11-05
很详细的esp32， windows下搭建环境配置、及编译环境的说明文档，文档有图片，希望对大家有帮助。
ESP32教程-Windows开发环境搭建
09-19
《ESP32 技术参考手册》 的目标读者群体是使用 ESP32 芯片的应用开发工程师。本手册提供了关于 ESP32 的具 体信息，包括各个功能模块的内部架构、功能描述和寄存器配置等。 芯片的管脚描述、电气特性和封装信息等可以从《ESP32 技术规格书》 获取。
ESP32C3学习&开发之路——VScode开发环境搭建
RMDYBW的博客
06-30 4762
搭建在VScode的软件上开发ESP32系列WiFi模组的开发环境
ESP32-IDF环境搭建之VScode环境
Jeremyrev的博客
07-20 1404
如何搭建 VSCODE+Espressif IDF 编程环境
Vscode运行 ESP-IDF编译报错 Re-running cMAKE
weixin_64260764的博客
10-07 322
re-running cmake
【环境篇】ESP-IDF零基础入门 2 —— 搭建开发环境2
qq_33249042的博客
09-01 5031
ESP-IDF 环境搭建劝退？跟着我，带你轻松搭建 ESP32 应用程序开发环境！
xtensa-esp32-elf-g++: error: C:/Users/mumian/.platformio/packages/framework-arduinoespressif32/cores/esp32/Esp.cpp
07-28
根据提供的引用内容，问题是关于xtensa-esp32-elf-g++的错误。根据引用\[1\]和引用\[2\]的信息，xtensa-esp32-elf-gcc命令未找到，可能是因为缺少Xtensa工具链或者路径配置不正确。引用\[3\]提供了一个解决方法，可以执行export.sh脚本来添加ESP-IDF工具到PATH中，然后重新编译项目。请尝试执行以下步骤来解决问题： 1. 打开终端并导航到项目目录。 2. 执行以下命令：`. ./export.sh`。这将添加ESP-IDF工具到PATH中。 3. 确保Python包已更新并满足要求。 4. 重新编译项目，执行命令：`idf.py build`。 这样应该能够解决xtensa-esp32-elf-g++错误。如果问题仍然存在，请确保你的Xtensa工具链已正确安装，并且路径配置正确。 #### 引用[.reference_title] - *1* [ubuntu命令行出现/bin/sh: xtensa-esp32-elf-gcc: not found WARNING: Failed to find Xtensa toolchain...](https://blog.csdn.net/qq_40773212/article/details/108931402)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control,239^v3^insert_chatgpt"}} ] [.reference_item] - *2* *3* [【问题解决】ESP32报错：make: xtensa-esp32-elf-gcc: Command not found](https://blog.csdn.net/p1279030826/article/details/111683583)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 20
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值