ESP-IDF 环境搭建

最新推荐文章于 2024-06-06 19:33:06 发布
最新推荐文章于 2024-06-06 19:33:06 发布
阅读量3k 收藏 10
点赞数 2
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Linux_zhicheng/article/details/108595233
版权

这里是乐鑫 IoT 开发框架 (esp-idf) 的文档中心。ESP-IDF 是 ESP32 和 ESP32-S2 系列芯片的官方开发框架。

本文档仅包含针对 ESP32 芯片的 ESP-IDF 使用。如需了解其他芯片，请点击页面左下方的 “Switch Version”。

ESP-IDF 是 ESP32 芯片的官方开发框架。

快速入门

[English]

本文档旨在指导用户搭建 ESP32 硬件开发的软件环境，通过一个简单的示例展示如何使用 ESP-IDF (Espressif IoT Development Framework) 配置菜单，并编译、下载固件至 ESP32 开发板等步骤。

注解

这是ESP-IDF master 分支（最新版本）的文档，该版本在持续开发中。还有 Stable version 的文档，以及其他版本的文档 ESP-IDF 版本简介 供参考。

概述

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

乐鑫为用户提供完整的软、硬件资源，进行 ESP32 硬件设备的开发。其中，乐鑫的软件开发环境 ESP-IDF 旨在协助用户快速开发物联网 (IoT) 应用，可满足用户对 Wi-Fi、蓝牙、低功耗等方面的要求。

准备工作

硬件：

  • 一款 ESP32 开发板

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

  • PC（Windows）

软件：

  • 设置 工具链，用于编译 ESP32 代码；

  • 编译工具 —— CMake 和 Ninja 编译工具，用于编译 ESP32 应用程序；

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

  • 安装 C 语言编程（工程）的 文本编辑器，例如 Eclipse。

ESP32 应用程序开发

ESP32 应用程序开发

开发板简介

请点击下方连接，了解有关具体开发板的详细信息。

详细安装步骤

请根据下方详细步骤，完成安装过程。

设置开发环境

创建您的第一个工程

安装准备

在正式开始创建工程前，请先完成工具的安装，具体步骤见下：

Windows 平台工具链的标准设置

[English]

注解

目前，基于 CMake 的构建系统仅支持 64 位 Windows 版本。32 位 Windows 版本的用户可根据 传统 GNU Make 构建系统 中的介绍进行操作。

概述

ESP-IDF 需要安装一些必备工具，才能围绕 ESP32 构建固件，包括 Python、Git、交叉编译器、menuconfig 工具、CMake和 Ninja 编译工具等。

在本入门指南中，我们通过 命令提示符 进行有关操作。不过，您在安装 ESP-IDF 后还可以使用 Eclipse 或其他支持 CMake 的图形化工具 IDE。

注解

较早 ESP-IDF 版本使用 传统 GNU Make 编译系统 和 MSYS2 Unix 兼容环境。但如今已非必需，用户可直接通过 Windows 命令提示符使用 ESP-IDF。

使用命令提示符

等待这个命令执行结束，再执行下一条命令，不要开多个终端同时执行！

开始创建工程

现在，您可以开始准备开发 ESP32 应用程序了。您可以从 ESP-IDF 中 examples 目录下的 get-started/hello_world 工程开始。

将 get-started/hello_world 复制至您本地的 ~/esp 目录下

Windows 操作系统

cd %userprofile%\esp\hello_world
idf.py menuconfig

如果有这个错误

则根据提示来

如果有这个错误：

也是根据提示来

总之，就是出什么问题都会有提示，根据提示，一步一步操作就OK，接下来

Windows 操作系统

Windows 下命令提示符窗口使用 ESP-IDF，请使用下方代码：

进入esp\esp-idf目录执行export.bat添加环境变量，再开始创建工程，拷贝hello目录只esp目录，执行
idf.py menuconfig

如果之前的步骤都正确，则会显示下面的菜单

进入这个界面：

工程配置 — 主窗口

menuconfig 工具的常见操作见下。

  • 上下箭头：移动

  • 回车：进入子菜单

  • ESC 键：返回上级菜单或退出

  • 英文问号：调出帮助菜单（退出帮助菜单，请按回车键）。

  • 空格``或 ``Y 键：选择 [*] 配置选项；N 键：禁用 [*] 配置选项

  • 英文问号 （查询配置选项）：调出有关该选项的帮助菜单

  • / 键：寻找配置工程

注意

如果您使用的是 ESP32-DevKitC（板载 ESP32-SOLO-1 模组），请在烧写示例程序前，前往 menuconfig 中使能单核模式（CONFIG_FREERTOS_UNICORE）。

SDK tool configuration配置SDK 开发工具链的信息，一般未编译自己工具链时不用修改
Bootloader config配置BootLoader 启动时的日志打印级别
Serial flasher config配置串口下载时使用的端口、波特率、Flash 模式、Flash 频率、是否压缩上传等
Partition Table配置分区信息，可选择默认分区配置或自定义分区配置
Component config组件配置 包含ESP32的特殊配置、WiFi配置、BLE配置、FreeRTOS配置、LWIP配置、日志配置、SPI配置、用户程序自定义配置等

SDK tool configuration

Compiler toolchain path/prefixxtensa-esp32-elf-该配置项一般无需配置，除非自己编译交叉编译链时，且使用了跟 xtensa-esp32-elf- 不同的名字。
Python 2 interpreterpythonpython 2 解释器的名称，一般默认都是python。

Bootloader config

Bootloader log verbosityWarning这里可以配置BootLoader的日志打印级别，级别越高，打印出的日志信息量越多,可以根据自己的需要选择合适的级别。
级别排序为：No output < Error < Warning < Info < Debug < Verbose 。

Serial flasher config

项目默认值备注
Default serial port/dev/ttyUSB0windows 下的 COM1 对应 cygwin 下的/dev/ttyS0 ，COM2 对应 ttyS1，以此类推。
Default baud rate921600您可以选择 230400/921600/2M/Other baud rate ,如果您选择了 Other baud rate，则需要在下面手动输入您认为可用的下载速率，ESP32 目前最大的下载速率为 1152000.
Use compressed upload是是否选择压缩上传，可以提升固件下载时的速度。
Flash SPI modeDIOSPI运行模式，推荐DIO方式
Flash SPI speed40MHZSPI 速率，需要根据自己的 Flash 型号进行配置，部分型号的Flash不支持过高的速率。

Partition Table

项目默认值可选值备注
Partition TableSingle factory app, no OTASingle factory app, no OTA
Factory app, two OTA definitions
Custom partition table CSV		默认分区文件地址为:components/partition_table
一般使用Single factory app, no OTA 。
自定义分区可以参考下面的示例

如何修改自定义分区表

下面以 NodeMCU 的 spiffs 分区为例：

1 勾选 Custom partition table CSV

2 在 Custom partition table CSV 中输入自定义的分区信息文件名：partitions-2MB.csv

3 在工程的根目录下建立 partitions-2MB.csv文件（参考 components/platform/partitions-2MB.csv）

# Espressif ESP32 Partition Table
# NameTypeSubTypeOffsetSize
factoryappfactory0x100001M
rfdatadatarf0x110000256K
wifidatadatawifi0x150000256K
# 0xC2 ⇒ NodeMCU 0x0 ⇒ Spiffs
spiffs0xC20x0 448K

4 编译下载。

具体的分区使用详情可以参考 https://github.com/espressif/esp-idf/blob/master/docs/partition-tables.rst

编译工程

请使用以下命令，编译烧录工程：:

idf.py build

编译好了如下

如果一切正常，编译完成后将生成 .bin 文件。

烧录到设备

请使用以下命令，将刚刚生成的二进制文件烧录至您的 ESP32 开发板：

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

请将 PORT 替换为 ESP32 开发板的串口名称

您还可以将 BAUD 替换为您希望的烧录波特率。默认波特率为 460800。

更多有关 idf.py 参数的详情，请见 idf.py：

https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/api-guides/build-system.html#idf-py

输入：

idf.py -p COM11 -b 460800 flash

如果一切顺利，烧录完成后，开发板将会复位，应用程序 “hello_world” 开始运行。

监视器

您可以使用 idf.py -p PORT monitor 命令，监视 “hello_world” 的运行情况。注意，不要忘记将 PORT 替换为您的串口名称。

运行该命令后，IDF 监视器 应用程序将启动：:

$ idf.py -p /dev/ttyUSB0 monitor
Running idf_monitor in directory [...]/esp/hello_world/build
Executing "python [...]/esp-idf/tools/idf_monitor.py -b 115200 [...]/esp/hello_world/build/hello-world.elf"...
--- idf_monitor on /dev/ttyUSB0 115200 ---
--- Quit: Ctrl+] | Menu: Ctrl+T | Help: Ctrl+T followed by Ctrl+H ---
ets Jun  8 2016 00:22:57

rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
ets Jun  8 2016 00:22:57
...

此时，您就可以在启动日志和诊断日志之后，看到打印的 “Hello world!” 了。

...
Hello world!
Restarting in 10 seconds...
I (211) cpu_start: Starting scheduler on APP CPU.
Restarting in 9 seconds...
Restarting in 8 seconds...
Restarting in 7 seconds...

您可使用快捷键 Ctrl+]，退出 IDF 监视器。

如果 IDF 监视器在烧录后很快发生错误，或打印信息全是乱码（见下），很有可能是因为您的开发板采用了 26 MHz 晶振，而 ESP-IDF 默认支持大多数开发板使用的 40 MHz 晶振。

乱码输出

此时，您可以：

  1. 退出监视器。

  2. 打开 menuconfig。

  3. 进入 Component config –> ESP32-specific –> Main XTAL frequency 进行配置，将 CONFIG_ESP32_XTAL_FREQ_SEL 设置为 40 MHz。

  4. 然后，请重新 编译和烧录 应用程序。

注解

您也可以运行以下命令，一次性执行构建、烧录和监视过程：

idf.py -p PORT flash monitor

更新 ESP-IDF

根据https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/get-started/index.html 教程更新

 

乐鑫会不时推出更新版本的 ESP-IDF，修复 bug 或提出新的特性。因此，您在使用时，也应注意更新您本地的版本。最简单的方法是：直接删除您本地的 esp-idf 文件夹，然后按照 第二步：获取 ESP-IDF 中的指示，重新完成克隆。

此外，您可以仅更新变更部分。具体方式，请前往 更新 章节查看。

注意，更新完成后，请执行 install.sh （Windows 系统中为 install.bat）脚本，避免新版 ESP-IDF 所需的工具也有所更新。具体请参考 第三步：设置工具。

一旦重新安装好工具，请使用“导出脚本”更新环境，具体请参考 第四步：设置环境变量。

 

总之提示缺什么安装什么，以下是我个人快速安装esp32环境以及常用命令

先安装Python环境，然后添加Python环境变量再进行下面操作
cd E:\BQ\Leo\esp\esp-idf-v4.0.1\esp-idf-v4.0.1
install.bat
pip install python
C:\User\Administrator\AppData\Local\Programs\Python\Python35-32\python.exe -m pip install --user virtualenv
C:\User\Administrator\AppData\Local\Programs\Python\Python35-32\python.exe -m pip install --user -r E:\BQ\Leo\esp\esp-idf-v4.0.1\esp-idf-v4.0.1\requirements.txt
python -m pip install --upgrade pip
export.bat
cd E:\BQ\Leo\esp\get-started\hello_world
idf.py menuconfig 		 		//配置信息
idf.py build       				//编译
idf.py -p COM4 flash			//烧录
idf.py -p COM4 monitor			//监视
idf.py -p COM4 flash monitor 	//烧终端录并显示串口
Ctrl + ] 退出监视
idf.py fullclean  				//清除


其他命令
idf.py --help 查看完整的命令列表
idf.py clean 会把构建输出的文件从构建目录中删除，从而清理整个项目
idf.py flash 会在必要时自动构建项目，并将生成的二进制程序烧录进 ESP32 设备中
	-p 和  -b 选项可分别设置串口的设备名和烧录时的波特率
idf.py monitor 用于显示 ESP32 设备的串口输出
	-p 选项可用于设置主机端串口的设备名
多个 idf.py 命令可合并成一个
	例如idf.py -p COM4 clean flash monitor 会依次清理源码树，构建项目，烧录进 ESP32 设备，最后运行串口监视器。

 

 

来自南陵县的平头哥
关注
  • 2
    点赞
  • 踩
  • 10
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
ESP-IDF 编程入门知识点（不定期更新）
01-20
此篇博客用来记录在 ESP-IDF 中看到的一些编程入门知识点。 1. 判断部分函数是否成功运行：esp_err_t 例：判断定时器是否成功停止 esp_err_t ret; ret = esp_timer_stop(timer_handle); ESP_ERROR_CHECK(ret); 2. GPIO 初始化并将值设为 高电平 例：设置 GPIO 16 为输出且设置为高电平 gpio_pad_select_gpio(16); gpio_set_direction(16, GPIO_MODE_OUTPUT); gpio_set_level(16, 1); 上述前两行代码也可以用以下来代替
ESP-IDF学习——1.环境安装与hello-world
weixin_45682654的博客
09-17 2334
学习ESP-IDF的环境搭建以及创建简单的demo工程
【ESP32】打造全网最强esp-idf基础教程——3.freeRTOS使用教学
最新发布
Hello_kitty_ling的博客
06-06 1195
esp-idf是基于freeRTOS的框架，里面用到的组件，以及我们的应用程序都是基于freeRTOS来开发的，因此我们必须掌握freeRTOS的用法。如果我们不深究原理，只关注于freeRTOS的接口使用，我们很快就能掌握。另外，因为freeRTOS开源免费的特性，目前大部分芯片产商做的SDK都是基于freeRTOS系统开发的，因此我们就更有理由要学习RTOS了。
ESP-IDF使用总结&避坑指南
weixin_55024277的博客
01-12 4641
espidf会默认把component文件夹下所有文件的路径包含进去，但是在component文件夹下构建自己的项目需要自己创建CMakeLists.txt文件，不然就会出现虽然文件能正常跳转但是编译的时候就会提示找不到xx文件的玄学问题。实际上大部分情况下修改factory的大小分给程序足够的存储空间即可，因为默认情况下只给factory分配了1M的内存，而我们可以选购拥有8MB、16MB的flash大小的芯片。esp32相关的头文件都是提示找不到路径的，虽然问题不大但是不能直接跳转了，也不方便调试。
【ESP-IDF篇】搭建ESP-IDF软件开发环境，包括手动命令行和VSCode两种方式
单片机菜鸟哥的博客
09-27 4206
ESP-IDF 是乐鑫主推的ESP32的开发框架，旨在协助用户快速开发物联网 (IoT) 应用，可满足用户对 Wi-Fi、蓝牙、低功耗等方面的要求。设置工具链，用于编译 ESP32 代码；编译构建工具 ——CMake 和 Ninja编译构建工具，用于编译 ESP32 应用程序；获取 ESP-IDF 软件开发框架。该框架已经基本包含 ESP32 使用的 API（软件库和源代码）和运行 工具链 的脚本；软件开发的搭建有三种选择：手动安装工具链，命令行方式（尝试，本篇介绍）使用。
ESP-IDF安装配置食用教程（以Windows系统示例）
jk4568的博客
02-22 9470
文章目录前言一、前期准备二、环境配置1.Python安装2.Git安装三、ESP-IDF安装四、其他五、结语 前言 徐小宝：本文仅以经验指南，涉及ESP-IDF安装，编译环境配置等。 一、前期准备 1、Git安装包，移步官网下载 2、Python安装包，移步官网下载 3、ESP-IDF文件包，移步官方Github下载或Gitee下载 4、本博文所用文件，移步附件（ESP-IDF环境安装文件，含esp-idf-v4.0.1资源包、Git-2.35.1.2-64-bit安装包、python-3.7.9-amd
esp32-vscode-esp-idf小灯闪烁的源码
08-11
"esp32-vscode-esp-idf小灯闪烁的源码"项目，主要是指导如何使用Visual Studio Code (VSCode)作为集成开发环境(IDE)，配合ESP-IDF框架来实现一个简单的LED灯闪烁程序。VSCode以其强大的代码编辑、调试和扩展功能，...
esp-idf远程仓库
04-14
总的来说，“esp-idf远程仓库”是开发ESP32和ESP8266物联网项目的宝贵资源，对于Linux（尤其是Ubuntu）用户，它提供了完整的开发环境和工具链，能够帮助开发者快速搭建并管理他们的物联网应用程序。
无梯子在Linux下搭建ESP-IDF开发环境
01-31
因为Github网速太慢，这里特地使用gitee在Linux下搭建VS CODE开发ESP-IDF环境，里面是相关笔记和资料。
ESP32环境搭建包（msys2、esp-idf、VScode）
12-14
windows环境资源包，包含esp-idf-v3.3.zip、esp32_win32_msys2_environment_and_toolchain-20181001.zip、VSCodeUserSetup-x64-1.38.1.exe 环境搭建参考博文：...
esp32用到的esp-idf工具
01-20
在开发ESP32项目时，首先需要搭建ESP-IDF开发环境。以下是一步步详细介绍： 1. **安装依赖软件**：在开始ESP-IDF开发前，确保你的计算机上已经安装了Git、CMake、Python 3.6或更高版本以及VSCodium或Visual Studio ...
【环境篇】ESP-IDF零基础入门 1 —— 搭建开发环境1
qq_33249042的博客
08-25 9336
ESP-IDF 环境搭建劝退？跟着我，带你轻松搭建 ESP32 应用程序开发环境！
esp-idf使用教程
weixin_44103123的博客
07-19 2559
乐鑫编程指南新建一个配置文件，Kconfig.projbuild打开menuconfig查看新增配置设置.c文件获取项目配置文件中的值。你可以在菜单中动态设置一个变量，该变量的声明会出现在项目配置文件中，复制变量名到源代码文件中即可引用菜单动态设置的变量。
ESP32 系列之 ESP-IDF 官方构建方案
蓝创精英团队
06-30 3925
ESP32 SoC 芯片支持以下功能：ESP32 采用 40 nm 工艺制成，具有最佳的功耗性能、射频性能、稳定性、通用性和可靠性，适用于各种应用场景和不同功耗需求。乐鑫为用户提供完整的软、硬件资源，进行 ESP32 硬件设备的开发。其中，乐鑫的软件开发环境 ESP-IDF 旨在协助用户快速开发物联网 (IoT) 应用，可满足用户对 Wi-Fi、蓝牙、低功耗等方面的要求。可以参考这篇文章https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp3
00-ESP-IDF 环境配置指南
m0_60134435的博客
03-09 1821
1.首先我们在浏览器搜索esp-idf，点击第一个选项2.点击右边栏的安装3.我们选择手动安装选择需要的系统版本4.点击链接5.这里我们选择一个版本，建议不要选择最新的，安装出现问题在网上不好找到解决办法6.下载完成之后点击运行，一直选择下一步安装完成后，在我们的桌面会多出两个图标7.我们点击第一个图标，这是CMD的命令行工具，在命令行中输入idf.py出现以下信息表示安装成功了。
【ESP-IDF】介绍NVS
qq_45430571的博客
04-17 1610
介绍NVS
ESP32-IDF开发笔记 | 01 - ESP-IDF开发环境搭建（2023.04.08更新）
热门推荐
Mculover666的博客（嵌入式）
05-01 2万+
一、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
深入理解ESP-IDF构建系统
blog.boringhex.top
08-16 803
ESP-IDF 基础库，包括 libc、ROM bindings 等Wi-Fi 驱动TCP/IP 协议栈FreeRTOS 操作系统网页服务器湿度传感器的驱动负责将上述组件整合到一起的主程序ESP-IDF 可以显式地指定和配置每个组件。在构建项目的时候，构建系统会前往 ESP-IDF 目录、项目目录和用户自定义组件目录（可选）中查找所有组件，允许用户通过文本菜单系统配置 ESP-IDF 项目中用到的每个组件。在所有组件配置结束后，构建系统开始编译整个项目。
通过ESP-IDF开发环境搭建（Windows）
hansen_education的博客
02-12 967
ESP32开发环境搭建，基于IDF开发； 嵌入式学习 ，单片机学习，linux
ESP-IDF环境搭建
09-06
你好！要搭建 ESP-IDF 环境，你可以按照以下步骤进行： 1. 首先，确保你的开发环境已经安装了 Python 和 Git。ESP-IDF 是使用 Python 脚本来配置和编译的，而 Git 则用于从 GitHub 上获取 ESP-IDF。 2. 下载 ESP-IDF。你可以在 GitHub 上找到它的仓库：https://github.com/espressif/esp-idf 通过以下命令可以克隆该仓库： ``` git clone --recursive https://github.com/espressif/esp-idf.git ``` 3. 设置 ESP-IDF 环境变量。进入 esp-idf 目录，执行以下命令： ``` ./install.sh ``` 4. 根据你的操作系统，执行对应的脚本来设置环境变量。例如，在 Linux/macOS 上，执行： ``` source $HOME/esp/esp-idf/export.sh ``` 5. 验证环境是否设置成功。执行以下命令： ``` idf.py --help ``` 如果能够正确显示帮助信息，则说明环境已经搭建成功。 这样，你就成功搭建了 ESP-IDF 环境。接下来，你可以使用 ESP-IDF 开发 ESP32 系列的应用程序了。如果需要更多的信息和帮助，可以参考 ESP-IDF 的官方文档：https://docs.espressif.com/projects/esp-idf/en/latest/

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

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

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值