ESP32开发__ESP-IDF, ESP-ADF官网下载,安装及环境配置

目录

前言

1. 概述

2. 企业概况

3. ESP-ADF

4. 准备工作

5. ESP-IDF安装,配置及编译DEMO

5.1. 使用什么版本?

5.2. 软件下载与安装( ESP-IDF v5.2.1 )

5.2.1. 离线安装程序下载(离线安装)

5.2.2. 安装“入门指南”中提到的构建所依赖的工具,无脑“下一步”

5.2.3. 设置构建环境

5.2.4. 开始使用ESP-IDF

5.3. 官方ESP-IDF编程指南 -> 快速入门

6. ESP-ADF安装,配置及编译DEMO

6.1. 使用什么版本?

6.2. 调用git命令克隆仓库:

6.3. 删除文件夹,克隆仓库,下载 ESP-IDF V5.2.1 版本

6.4. 删除文件夹,克隆仓库,下载 esp-adf-libs 版本

6.5. 删除文件夹,克隆仓库,下载 esp-adf-libs 版本

6.6. 设置环境变量

6.7. 官方ESP-ADF编程指南 -> 快速入门

7. 帮你们提前下载好了喔! ( 官网下载, 拒绝账号注册的烦恼, 官方网站响应慢)

7.1. CSDN

7.2. 百度网盘

7.2.1. esp-idf-tools-setup-offline-4.4.7.exe

7.2.2. esp-idf-4.4.7

7.2.3. esp-adf-2.6

7.2.4. esp-adf-libs

7.2.5. esp-sr

(* ̄︶ ̄)创作不易!期待你们的 点赞、收藏和评论喔。


前言

不说废话,直面“干货”。最近公司项目涉及基于 ESP32 系列芯片开发,那我们新手小白如何准备相关工作及快速入门,本篇文章旨在:介绍ESP32,指导用户搭建 ESP32 硬件开发的软件环境( ESP-IDF V4.4.7 和 ESP-ADF master )和运行简单的例程DEMO确认开发环境正确安装。

考虑到编译效率问题,我选择“离线下载

1. 概述

ESP32 是一款功能丰富的 SoC,集成 Wi-Fi 4 和 蓝牙,适用于多样的物联网应用,具有 高性能、高集成、低功耗和多种接口的特点,可作为独立系统或从设备提供 Wi-Fi 和 …

  • 2.4 GHz Wi-Fi

  • 蓝牙

  • 高性能 Xtensa® 32 位 LX6 双核处理器

  • 超低功耗协处理器

  • 多种外设

ESP32 采用 40 nm 工艺制成,具有最佳的功耗性能、射频性能、稳定性、通用性和可靠性,适用于各种应用场景和不同功耗需求。

2. 企业概况

英文全称:ESPRESSIF SYSTEMS (SHANGHAI) CO., LTD.

官网地址:https://www.espressif.com.cn/zh-hansicon-default.png?t=O83Ahttps://www.espressif.com.cn/zh-hans

总部位于上海张江高科技园区,是一家先进、专业的、全球化的无晶圆半导体公司,致力于研发设计 Wi-Fi 和蓝牙技术的无线系统级芯片,提供移动通讯和物联网解决方案

乐鑫科技(股票代码:688018)成立于 2008 年,在中国、捷克、印度、新加坡和巴西均设有办公地,团队来自约 30 个国家和地区。乐鑫多年来深耕 AIoT 领域软硬件产品的研发与设计,专注于研发高集成、低功耗、性能卓越、安全稳定、高性价比的无线通信 SoC,现已发布 ESP8266ESP32ESP32-SESP32-CESP32-H 系列芯片、模组和开发板,成为物联网应用的理想选择。我们致力于提供安全、稳定、节能的 AIoT 解决方案。同时,我们坚持技术开源,助力开发者们用乐鑫的方案开发智能产品,打造万物互联的智能世界。2019年7月,乐鑫科技在上海证券交易所科创板挂牌上市。

乐鑫以开源的方式建立了开放、活跃的技术生态系统。自主研发了一系列开源的软件开发框架,如操作系统ESP-IDF音频开发框架 ESP-ADFMesh 开发框架 ESP-MDF设备连接平台 ESP RainMaker人脸识别开发框架 ESP-WHO 和 智能语音助手 ESP-Skainet 等,以此构建了一个完整、创新的 AIoT 应用开发平台。同时,乐鑫也支持许多创客社区的开源项目,让开发者们自由开发项目应用、交流技术心得。随后乐鑫的芯片和模组受到越来越多客户的青睐,被广泛应用于智能家居、电工、照明、智能音箱、消费电子、移动支付等领域。

3. ESP-ADF

ESP-ADF 以最全面的方式支持乐鑫 SoC 的音频应用程序开发。使用 ESP-ADF,您可以轻松添加功能,从简单到复杂开发音视频应用程序:

  • 音乐播放器或录音机支持MP3,AAC,FLAC,WAV,OGG,OPUS,AMR,TS,EQ,Downmixer,Sonic,ALC,G.711等音频格式。
  • 播放来自以下来源的音乐:HTTP、HLS(HTTP Live Streaming)、SPIFFS、SDCARD、A2DP-Source、A2DP-Sink、HFP 等。
  • 集成媒体协议,如:DLNA、VoIP、RMTP、ESP-RTC(SIP、RTSP 和 RTCP)等。
  • 视频通话视频录制视频直播
  • 网络电台
  • 语音识别和与AlexaDuerOS等在线服务的集成。

一般情况下,ESP-ADF 功能将支持如下所示:

49fd649e60dc27ec76b3c6273d94381d.png

4. 准备工作

  • 1款 ESP32 开发板,我用的开发板是:ESP32-S3-Korvo-2 v3

  • USB 数据线 (A 转 Micro-B)

  • 电脑(Windows、Linux 或 macOS)

目前一些开发板使用的是 USB Type C 接口。请确保使用合适的数据线来连接开发板!

5. ESP-IDF安装,配置及编译DEMO

 注意:我这里使用的是:ESP-IDF最新稳定版本 V5.3.1 ,版本介绍的文档如下,仅供参考ESP-IDF 版本简介icon-default.png?t=O83Ahttps://docs.espressif.com/projects/esp-idf/zh_CN/v5.3.1/esp32/versions.html

5.1. 使用什么版本?

如果你是用在工作的项目量产,当然首选还是使用稳定版本( 最新稳定版本 V5.3.1 ),ESP-IDF 的 GitHub 仓库时常更新,特别是用于开发新特性的 master 分支。下表总结了乐鑫芯片在 ESP-IDF 各版本中的支持状态,预览支持状态通常有时间限制,而且仅适用于测试版芯片。请确保使用与芯片相匹配的 ESP-IDF 版本。

ESP-IDF版本与芯片型号
芯片V4.4V5.0V5.1V5.2V5.3-
ESP32支持支持支持支持支持
ESP32-S2支持支持支持支持支持
ESP32-C3支持支持支持支持支持
ESP32-S3支持支持支持支持支持芯片发布公告
ESP32-C2支持支持支持支持芯片发布公告
ESP32-C6支持支持支持芯片发布公告
ESP32-H6支持支持支持芯片发布公告
ESP32-P4支持支持芯片发布公告
ESP32-C5预览芯片发布公告

上述的 V5.2.1V5.2 下继续开发的Bugfix 版本,仅修复 bug,并不增加任何新特性;V5.2 是是 V5.0 继续开发的次要版本,代表有新增特性和 bug 修复,但现有特性不受影响,公开 API 的使用也不受影响。(升级至一个新的次要版本意味着你可能不需要更新工程代码,但需重新测试工程,特别是 发布说明页面中 专门提到的部分。)

当然,用于嵌入式的开发学习,我们可以基于最新版的框架去开发,通过以下链接,可以访问各个版本的配套文档:

最新稳定版 ESP-IDF:ESP-IDF 编程指南 - ESP32 - — ESP-IDF 编程指南 v5.3.1 文档 (espressif.com)

最新版 ESP-IDF(即 master 分支):ESP-IDF 编程指南 - ESP32 - — ESP-IDF 编程指南 latest 文档 (espressif.com)

每款乐鑫芯片都可能有不同版本。建议参考 ESP-IDF 版本与乐鑫芯片版本兼容性,了解 ESP-IDF 版本与各芯片版本之间的兼容性。

对于 2016 年之前发布的乐鑫芯片(包括 ESP8266 和 ESP8285),请参考 RTOS SDK

ESP-IDF 在 GitHub 平台上的完整发布历史请见 发布说明页面。该页面支持查看各个版本的发布说明、配套文档及相应获取方式。

此外,也可以直接前往文档页面,查看不同 ESP-IDF 版本的配套文档,具体可点击页面左上角中版本的下拉菜单(在目标下拉菜单和搜索栏之间),实现在不同版本间切换。

旧版本的文档也仍然可用:

v5.2 - Release Notesv5.1.2 - Release Notesv5.1.1 - Release Notes
v5.1 - Release Notesv5.0.5 - Release Notesv5.0.4 - Release Notes
v5.0.3 - Release Notesv5.0.2 - Release Notesv5.0.1 - Release Notes
v5.0 - Release Notesv4.4.6 - Release Notesv4.4.5 - Release Notes
v4.4.4 - Release Notesv4.4.3 - Release Notesv4.4.2 - Release Notes
v4.4.1 - Release Notesv4.4 - Release Notesv4.3.6 - Release Notes
v4.3.5 - Release Notesv4.3.4 - Release Notesv4.3.3 - Release Notes
v4.3.2 - Release Notesv4.3.1 - Release Notesv4.3 - Release Notes
v4.2.5 - Release Notesv4.2.4 - Release Notesv4.2.3 - Release Notes
v4.2.2 - Release Notesv4.2.1 - Release Notesv4.2 - Release Notes
v4.1.4 - Release Notesv4.1.3 - Release Notesv4.1.2 - Release Notes
v4.1.1 - Release Notesv4.1 - Release Notesv4.0.4 - Release Notes
v4.0.3 - Release Notesv4.0.2 - Release Notesv4.0.1 - Release Notes
v4.0 - Release Notesv3.3.6 - Release Notesv3.3.5 - Release Notes
v3.3.4 - Release Notesv3.3.3 - Release Notesv3.3.2 - Release Notes
v3.3.1 - Release Notesv3.3 - Release Notesv3.2.5 - Release Notes
v3.1.7 - Release Notesrelease-v4.2release-v4.1
release-v4.0release-v3.3

5.2. 软件下载与安装( ESP-IDF v5.2.1 )

  • 设置 工具链,用于编译 ESP32 代码;

  • 编译构建工具 —— CMake 和 Ninja 编译构建工具,用于编译 ESP32 应用程序

  • 获取 ESP-IDF 软件开发框架。该框架已经基本包含 ESP32 使用的 API(软件库和源代码)和运行 工具链 的脚本

3ea53a31243230f2deff58041dee2631.png

5.2.1. 离线安装程序下载(离线安装)

Windows Installer Downloadicon-default.png?t=O83Ahttps://dl.espressif.cn/dl/esp-idf/?idf=4.497d2c592f9ae9a51efc2e2b1367ac2c5.png

点击下载

ESP-IDF v5.2.1 - Offline Installer(Windows 10, 11;Size: 1.5 GB)icon-default.png?t=O83Ahttps://dl.espressif.com/dl/idf-installer/esp-idf-tools-setup-offline-5.2.1.execd18c9f9d53312f73b55a4ab70965510.png

5.2.2. 安装“入门指南”中提到的构建所依赖的工具,无脑“下一步”

e8a093b10f06fbd190a1d2e4214d48ac.png

d1f0c2f4d3f45f4b92b3d86a42b0763d.png

5fb3baebb24de322d85b8b3f764dc847.png

 943eee60dca48e235ed96ad6cd190099.png

本次项目,我用到的是“ 通用型 Wi-Fi + 低功耗蓝牙 MCU 模组 ESP32-S3-WROOM-1U

a0932a7326d1bcba49d78f4530c4e8c9.png

安装目录:我的选择是F:\盘的根目录

10d9cd6e12ce93efa026b14b24351a14.png0e9b95a25ab544f51d5c993e1bd981dc.png347caa1dd65bbe90de14524850dcbee3.png

f96146487249e60c2acbf310f399fb05.png

离线安装程序不需要任何网络连接。安装程序中包含了所有需要的依赖文件,包括 Git For Windows 安装器。

安装程序会安装以下组件:

  • 内置的 Python

  • 交叉编译器

  • OpenOCD

  • CMake 和 Ninja 编译工具

  • ESP-IDF

5.2.3. 设置构建环境

(1)运行安装脚本,设置构建环境。可为 Windows shell 选择 install.bat 或 install.ps1

1042c4a6dfa54273ac4967319aae591b.png

273d409109daa5b478cf98f6e371a33e.png

(2)在使用 ESP-IDF 之前,需要在 shell 中运行导出脚本。Windows 下可运行 export.bat

75b77b3c885b9e210e26fafdea459af1.png

6a3e4594107bb1bf1052a400c8d3de74.png

5.2.4. 开始使用ESP-IDF

从 ESP-IDF 中 examples 目录下的 get-started/hello_world 工程开始。

5.3. 官方ESP-IDF编程指南 -> 快速入门

https://docs.espressif.com/projects/esp-idf/zh_CN/v5.2.1/esp32/get-started/index.htmlicon-default.png?t=O83Ahttps://docs.espressif.com/projects/esp-idf/zh_CN/v5.2.1/esp32/get-started/index.html

6. ESP-ADF安装,配置及编译DEMO

ESP-ADF的安装是在 ESP-IDF已安装的基础上进行 的。

6.1. 使用什么版本?

ESP-ADF 目前支持的 ESP-IDF 版本如下表所示。

ESP-IDF 主分支被标记为不受支持,因为它引入的主要功能更改可能会导致与 ESP-ADF 发生冲突。但是,不受这些功能更改影响的 ADF 示例仍然可以在 IDF 主分支上正确运行。

已删除生命周期终止的 IDF 分支。有关详细信息,请参阅 IDF支持的期限

ESP-IDF
Release/v4.4
ESP-IDF
版本/v5.0Release/v5.0版本/v5.0
ESP-IDF
版本/v5.1Release/v5.1版本/v5.1
ESP-IDF
版本/v5.2Release/v5.2版本/v5.2
ESP-IDF
主控Master主控
ESP-ADF
Master

fc15df566b433bdd24aa7f27c4221826.png

fc15df566b433bdd24aa7f27c4221826.png

fc15df566b433bdd24aa7f27c4221826.png

fc15df566b433bdd24aa7f27c4221826.png

882baba45bfb39743d1cdadbd8f6453b.png

ESP-ADF
Release/v2.6

fc15df566b433bdd24aa7f27c4221826.png

 1

fc15df566b433bdd24aa7f27c4221826.png

fc15df566b433bdd24aa7f27c4221826.png

882baba45bfb39743d1cdadbd8f6453b.png

882baba45bfb39743d1cdadbd8f6453b.png

ESP-ADF
Release/v2.5

fc15df566b433bdd24aa7f27c4221826.png

 1

882baba45bfb39743d1cdadbd8f6453b.png

882baba45bfb39743d1cdadbd8f6453b.png

882baba45bfb39743d1cdadbd8f6453b.png

882baba45bfb39743d1cdadbd8f6453b.png

ESP-ADF
Release/v2.4

fc15df566b433bdd24aa7f27c4221826.png

 1

882baba45bfb39743d1cdadbd8f6453b.png

882baba45bfb39743d1cdadbd8f6453b.png

882baba45bfb39743d1cdadbd8f6453b.png

882baba45bfb39743d1cdadbd8f6453b.png

注1:ESP-ADF v2.4 内置的 IDF 分支目前为 IDF Release/v4.4。 

 最终决定,我使用的是 master 分支下的工程代码。

6.2. 调用git命令克隆仓库:

https://github.com/espressif/esp-adf/tree/mastericon-default.png?t=O83Ahttps://github.com/espressif/esp-adf/tree/master

克隆路径为:预安装的ESP-IDF安装目录下的 frameworks/

bcd56e2fa3c9b087a284e3f408f9f84a.png

安装成功后,我们进入 目录esp-adf 

24631e4abc6edd5644849d117b73e6bd.png

安装过后,会出现几个文件的克隆失败,分别是esp-idfesp-idf-libs(adf音频库)esp-sr(adf语音识别库),因为这些库在esp-adf-master仓库下都是以分支branch链接形式存储的。需要单独安装。

6.3. 删除文件夹,克隆仓库,下载 ESP-IDF V5.2.1 版本

删除空文件夹 esp-idf,克隆仓库:GitHub - espressif/esp-idf: Espressif IoT Development Framework. Official development framework for Espressif SoCs.Espressif IoT Development Framework. Official development framework for Espressif SoCs. - espressif/esp-idficon-default.png?t=O83Ahttps://github.com/espressif/esp-idf.git

85e3817cee86391c2a3b5d22850cbdd2.png

6.4. 删除文件夹,克隆仓库,下载 esp-adf-libs 版本

进入到 esp-adf\components 目录,删除空文件夹 esp-adf-libs ,克隆仓库https://gitclone.com/github.com/espressif/esp-adf-libsicon-default.png?t=O83Ahttps://gitclone.com/github.com/espressif/esp-adf-libs4e1d76131100bfc89f0840cc0342a0a6.png

6.5. 删除文件夹,克隆仓库,下载 esp-adf-libs 版本

进入到 esp-adf\components 目录,删除空文件夹 esp-adf-sr ,克隆仓库

https://gitclone.com/github.com/espressif/esp-sr.git

2f665e8f83814477047fdb095079ab5e.png

6.6. 设置环境变量

打开系统环境变量设置,添加ESP-ADF安装路径

bcf2d0fbf51e70b7e4778e34fde9051a.png

设置成功后,在命令行中输入命令echo %ADF_PATH%应该返回ESP-ADF 目录的路径。 

a012f4ae553a96c33b8209b315683492.png

6.7. 官方ESP-ADF编程指南 -> 快速入门

乐鑫音频应用开发指南 — ADF 音频应用开发框架 文档icon-default.png?t=O83Ahttps://espressif-docs.readthedocs-hosted.com/projects/esp-adf/zh-cn/latest/index.html

7. 帮你们提前下载好了喔! ( 官网下载, 拒绝账号注册的烦恼, 官方网站响应慢)

7.1. CSDN

esp-idf-tools-setup-offline-5.3.1资源-CSDN文库icon-default.png?t=O83Ahttps://download.csdn.net/download/weixin_44807874/89956620

7.2. 百度网盘

7.2.1. esp-idf-tools-setup-offline-4.4.7.exe

esp-idf-tools-setup-offline-4.4.7.exe_免费高速下载|百度网盘-分享无限制icon-default.png?t=O83Ahttps://pan.baidu.com/s/1vdhBJgatxWCUKHfgsrFYow?pwd=f22v

7.2.2. esp-idf-4.4.7

esp-idf-4.4.7.zip_免费高速下载|百度网盘-分享无限制icon-default.png?t=O83Ahttps://pan.baidu.com/s/1MDQImdDW0oYYX-M682IxCg?pwd=62dy

7.2.3. esp-adf-2.6

esp-adf-2.6.zip_免费高速下载|百度网盘-分享无限制icon-default.png?t=O83Ahttps://pan.baidu.com/s/1nBuzODGksNwmnLPPY2LPsw?pwd=2d98

7.2.4. esp-adf-libs

esp-adf-libs.7z_免费高速下载|百度网盘-分享无限制icon-default.png?t=O83Ahttps://pan.baidu.com/s/17NVq41olgKXdJoBWZA0hZA?pwd=ehue

7.2.5. esp-sr

esp-sr.7z_免费高速下载|百度网盘-分享无限制icon-default.png?t=O83Ahttps://pan.baidu.com/s/1LwMhJzLDACJLiDXEWQbgsQ?pwd=diz7


(* ̄︶ ̄)创作不易!期待你们的 点赞收藏评论喔。

本文来源网络,免费分享知识,版权归原作者所有。如涉及作品版权问题,请联系我进行删除!

esp32-freertos-sdk 工具包 See the Getting Started guide links above for a detailed setup guide. This is a quick reference for common commands when working with ESP-IDF projects: Setup Build Environment (See Getting Started guide for a full list of required steps with details.) Install host build dependencies mentioned in Getting Started guide. Add tools/ directory to the PATH Run python -m pip install -r requirements.txt to install Python dependencies Configuring the Project idf.py menuconfig Opens a text-based configuration menu for the project. Use up & down arrow keys to navigate the menu. Use Enter key to go into a submenu, Escape key to go out or to exit. Type ? to see a help screen. Enter key exits the help screen. Use Space key, or Y and N keys to enable (Yes) and disable (No) configuration items with checkboxes "[*]" Pressing ? while highlighting a configuration item displays help about that item. Type / to search the configuration items. Once done configuring, press Escape multiple times to exit and say "Yes" to save the new configuration when prompted. Compiling the Project idf.py build ... will compile app, bootloader and generate a partition table based on the config. Flashing the Project When the build finishes, it will print a command line to use esptool.py to flash the chip. However you can also do this automatically by running: idf.py -p PORT flash Replace PORT with the name of your serial port (like COM3 on Windows, /dev/ttyUSB0 on Linux, or /dev/cu.usbserial-X on MacOS. If the -p option is left out, idf.py flash will try to flash the first available serial port. This will flash the entire project (app, bootloader and partition table) to a new chip. The settings for serial port flashing can be configured with idf.py menuconfig. You don't need to run idf.py build before running idf.py flash, idf.py flash will automatically rebuild anything which needs it. Viewing Serial Output The idf.py monitor target uses the idf_monitor tool to display se
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

深漂3年的小镁铝

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值