《ESP32从0到1》之：快速入门

最新推荐文章于 2025-03-26 15:10:30 发布

IT搬砖客

最新推荐文章于 2025-03-26 15:10:30 发布

阅读量4.4k

点赞数 36

分类专栏： ESP32从0到1 文章标签：嵌入式硬件 iot 物联网

本文链接：https://blog.youkuaiyun.com/u013534357/article/details/141899829

版权

ESP32从0到1 专栏收录该内容

15 篇文章

订阅专栏

文章目录

前言
一、硬件准备
二、软件环境配置
欢迎关注并留言

前言

文章内容：搭建ESP32开发的软件环境，配合开发板，展示如何使用ESP-IDF配置菜单、编译、下载固件，运行一个入门示例。

一、硬件准备

一款 ESP32 开发板
USB 数据线（A 转 Micro-B）
电脑（Windows）

开发板选用型号：ESP32-LyraT-Mini V1.2

开发板简单介绍：ESP32-LyraT 是一个基于双核 ESP32 用于开发音频应用程序的硬件平台，例如 Wi-Fi音箱、蓝牙音箱、语音遥控器以及有一个或多个音频功能的智能家居应用等。ESP32-LyraT-Mini是一款单声道音频开发板。

开发板模组：ESP32-WROVER-E 模组。

ESP32-WROVER-E是一款通用型 Wi-Fi + Bluetooth + Bluetooth LE MCU 模组，功能强大，用途广泛，可以用于低功耗传感器网络和要求极高的任务，例如语音编码、音频流和MP3解码等。采用 PCB 板载天线。

二、软件环境配置

1.安装vscode

此步骤自行查询，不做记录。

2.安装ESP-IDF

● 新建一个文件夹，用于存放ESP-IDF安装过程中下载的各类文件。注意，文件夹路径尽量短，最好不要有中文。假设文件夹路径及名称“E:\ESP32”

● https://gitee.com/EspressifSystems/esp-idf/releases 下载最新版本的ESP-IDF，解压后文件包重新命名为“esp-idf”，放入之前新建的文件夹中。备注：esp-idf\components\mbedtls、esp-idf\components/lwip内容是压缩包，需要单独下载。gitee报错的话，可以从github下载（https://github.com/espressif/esp-idf）

● 打开vscode，点击左侧“extension”，搜索框中输入“ESP-IDF”，选择ESP-IDF扩展，点击“install”
添加ESP-IDF扩展
● 安装完成后会自动跳出配置页面。也可以ctrl+alt+P，搜索ESP-IDF config，选择“Configure ESP-IDF extension”
调出配置页面
● 配置页面中，选择“Global”，“USE EXISTING SETUP”，修改下载服务器为“Espressif”，选择“Find ESP-IDF in your system”，修改保存路径为之前新建的文件夹。注意，需记录路径，后续配置环境变量时要用。点击“install”开始安装。
在这里插入图片描述

● 安装成功则如下图所示。

注意事项：
1】文件夹名称和路径中最好不要有中文；
2】下载的esp-idf包必须要解压且命名为“esp-idf”，放入之前建的文件夹中，双击“esp-idf”打开文件夹内容应该就是github文件；
3】两个路径选择，第一个路径直接选择解压的“esp-idf”文件夹；第二个路径则可直接改写，系统会自动新建“.espressif”；
4】安装过程中如果因为网络等原因安装失败，则手动删除“.espressif”文件夹，重新进行配置。

● 配置环境变量。右击“我的电脑”->“属性”->“高级系统配置”->“环境变量”，系统变量中，点击“新建”，变量名输入“IDF-PATH”,输入之前记录的路径“E:\ESP32\esp-idf”，点击“确定”。再次点击“新建”，变量名输入“IDF_TOOLS_PATH”,输入之前记录的路径“E:\ESP32.espressif”，点击“确定”，点击“确定”完成环境变量的配置。
在这里插入图片描述

3.使用示例验证开发环境配置是否正确

● ctrl+alt+P，输入ESP-IDF show，选择“ESP-IDF: Show Examples Projects” ,选择“blink”，选择“Create Project using example blink”，在跳出的保存框中，选择之前建立的文件夹，新建Project文件夹，保存。用于存放新建的blink工程。
在这里插入图片描述
● 工作区中打开刚新建的bling工程
● 点击左下角“esp32”配置目标芯片，选择需要编译的项目及芯片
● 点击左下角编译按钮，对工程进行编译，编译成功如下图所示。

编译过程中出现的错误问题解决：
1】配置目标硬件时，提示Requirement ‘setuptools<71.0.1,>=21’ was not met. Installed version: 74.1.0。解决办法，打开ESP-IDF终端（如下图所示），输入“pip show setuptools”显示当前安装的版本；输入“pip uninstall setuptools”卸载当前版本；输入“pip install setuptools==67.6.1”,安装低版本。
在这里插入图片描述