220-ESP-IDF环境搭建及VScode配置
概述
- 因为掼蛋项目用的主控芯片是ESP32s3,而ESP32s3基于C/C++的开发环境有:ESP-IDF(适合底层开发)、Arduino Core for ESP32(上手较简单,自愿丰富)、PlatformIO等
- 我们主要用到的是ESP-IDF,所以这里讲一下ESP-IDF的环境搭建
ESP-IDF介绍
- ESP-IDF (Espressif IoT Development Framework):
- 性质: 这是乐鑫官方提供的最底层、功能最全面的开发框架。
- 语言: C/C++。
- 特点:
- 提供对 ESP32 硬件所有功能的底层访问和控制。
- 包含 FreeRTOS 实时操作系统。
- 提供丰富的组件和库(TCP/IP, Wi-Fi, Bluetooth, Drivers, Security等)。
- 性能最好,灵活性最高。
- 学习曲线相对较陡峭。
- 常用工具链/IDE:
- 命令行 + 文本编辑器: 使用
idf.py
命令行工具进行编译、烧录、监视。 - VS Code + Espressif IDF 扩展: 这是目前官方推荐且非常流行的方式。VS Code 提供了强大的代码编辑、调试功能,官方扩展则无缝集成了 ESP-IDF 的构建、烧录、监视、调试(需要 JTAG 调试器)等流程。
- Eclipse + IDF 插件: 乐鑫也提供过 Eclipse 的插件,但现在 VS Code 更为主流。
- 命令行 + 文本编辑器: 使用
搭建步骤
下载ESP-IDF
- 进入乐鑫官方编程指导指南:ESP-IDF编程指南(有很多下载方式,这里讲官方下载方法)
- 选择对应芯片ESP32s3,和对应版本(可以下载5.2版本)
- 向下滑,找到手动安装,选择对应系统(我们这里讲解win版)
- 接着选择win安装程序下载,进入选择5.2版本
- 安装包下载后,直接下一步安装就可以了。(下载安装、VScode配置时不要用338的网络,会有一些网络问题)
- 安装完成后电脑桌面上就会出现两个命令窗软件,PowerShell是一些更高级复杂的命令,CMD就是简单一点的命令,一般我们并不使用命令窗开发,我们使用VScode进行开发。
VScode配置(VScode的安装就不介绍了,下载安装即可)
ESP-IDF插件下载
- 打卡VScode,左侧点击扩展,搜索ESP-IDF,安装
配置
- 打开命令面板: 按 Ctrl+Shift+P
- 运行配置命令: 输入 ESP-IDF: Configure ESP-IDF extension 并选择它。
- 点击EXPRESS
- 选择对应的配置
- Select download server:选择下载的方式,这里从乐鑫下载
- Select ESP-IDF version:这个是选择的下载版本,这里选择本地下载的就可以
- Select ESP-IDF directory: 点击 “Browse” 并导航到你 ESP-IDF 源码的根目录
- Select ESP-IDF Tools directory: 点击 “Browse” 并导航到 ESP-IDF 工具的安装路径(通常是 C:\Espressif.espressif ,这是安装器创建的包含 python_env, tools 等子文件夹的目录)。
- 配置好后点击install,如果没有成功,且提示是python问题,可以尝试将ESP-IDF文件夹(安装时文件的位置)中的tool文件夹中的idf-python文件夹删除掉
- 弹出该界面说明配置成功了
新建工程
- 直接点击上面界面的New Project。或者打开命令面板: Ctrl+Shift+P,输入ESP-IDF:New Project
- 进入工程界面
- 工程名字、工程存放位置(提前建一个文件夹,不要有空格和中文)
- Choose ESP-IDF Board:下拉选择
ESP32-S3 chip (via builtin USB-JTAG)
- Choose serial port:选择我们的开发板对应串口
- 点击Choose Template
工程类型
- 这里是乐鑫的示例工程,想要学习ESP32的伙伴,非常推荐学习一下官方示例工程
- 这里我们选择
sample-project
,也就是空工程 - 点击创建工程,然后点击yes(在新窗口打卡工程)
- 在打开的新窗口中,我们会看到我们的空工程,现在可以把原有窗口叉掉了
其他
- 到这里配置就结束了,空工程汇总包含的是一些必要性文件,有兴趣的伙伴可以查查都是什么作用。
- 我们可以进一步尝试编译空工程,
- 点击构建项目按钮进行编译项目,输出以上信息,即编译成功。接下来就可以对我们的esp32s3进行下一步开发啦!