esp 开发文档 esp开发环境

目录

• 简介
• 工具安装

• 环境准备
• IDE安装
• 其他工具安装
• 使用命令提示符

• 基本使用

• 官方命令--安装简单
• VScode编译下载--安装复杂

• 注意事项
• 问题列表

• cmake路径不在环境变量中
• 编辑不通过

简介

ESP-IDF 是乐鑫官方的物联网开发框架，适用于 ESP32、ESP32-S 和 ESP32-C 系列 SoC。它基于 C/C++ 语言提供了一个自给自足的 SDK，方便用户在这些平台上开发通用应用程序。ESP-IDF 目前已服务支持数以亿计的物联网设备，并已开发构建了多种物联网产品，例如照明、消费电子大小家电、支付终端、工控等各类物联网设备。

工具安装

官网链接：esp32 c3快速入门

环境准备

• esp32-c3开发板
• 编译工具链
• 编译构建工具cmake和Ninja
• ESP-IDF软件开发框架
• 编辑器安装

IDE安装

安装教程：esp-idf

1. 直接在vscode扩展里搜索Espressif IDF安装即可。
2. 插件配置，按ctrl shift p输入：Configure ESP-IDF extension，注意观察右下角进度，关于配置在后文有说明

其他工具安装

ESP-IDF 需要安装一些必备工具，才能围绕 ESP32-C3 构建固件，包括 Python、Git、交叉编译器、CMake 和 Ninja 编译工具等。 在快速入门点击：ESP-IDF 工具安装器 这将会安装如下内容：

• 内置的 Python
• 交叉编译器
• OpenOCD
• CMake 和 Ninja 编译工具
• ESP-IDF

关于工具的安装，这里直接参考链接的官方文档，采用离线安装，这里不记录

使用命令提示符

在后续步骤中，我们将使用 Windows 的命令提示符进行操作。 ESP-IDF 工具安装器可在“开始”菜单中，创建一个打开 ESP-IDF 命令提示符窗口的快捷方式。本快捷方式可以打开 Windows 命令提示符（即 cmd.exe），并运行 export.bat 脚本以设置各环境变量（比如 PATH，IDF_PATH 等）。此外，您可还以通过 Windows 命令提示符使用各种已经安装的工具。 注意，本快捷方式仅适用 ESP-IDF 工具安装器中指定的 ESP-IDF 路径。如果您的电脑上存在多个 ESP-IDF 路径（比如您需要不同版本的 ESP-IDF），您有以下两种解决方法：

1. 为 ESP-IDF 工具安装器创建的快捷方式创建一个副本，并将新快捷方式的 ESP-IDF 工作路径指定为您希望使用的 ESP-IDF 路径。
2. 或者，您可以运行 cmd.exe，并切换至您希望使用的 ESP-IDF 目录，然后运行 export.bat。注意，这种方法要求 PATH 中存在 Python 和 Git。如果您在使用时遇到有关“找不到 Python 或 Git”的错误信息，请使用第一种方法。

基本使用

首先下载examples，这里推荐自己的仓库esp32-idf，因为原仓库下载慢。

官方命令–安装简单

1. 拷贝examples目录下的例程到某一个目录
2. 配置工程

idf.py set-target esp32c3 #设置“目标”芯片，此操作将清除并初始化项目之前的编译和配置（如有） idf.py menuconfig #进行配置，示例代码中有默认配置可忽略 idf.py build #编译工程编译应用程序和ESP-IDF 组件，生成引导加载程序、分区表和应用程序二进制文件 idf.py menuconfig --help #显示帮助信息

3. 烧录程序

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

4. 监视输出

idf.py -p PORT monitor Ctrl+]，退出 IDF 监视器

VScode编译下载–安装复杂

1. 首先安装esp-idf插件，进行配置(搜索esp-idf configure)，这里会下载安装包，不过前面我们已经离线安装了esp-idf开发工具包，这里我们不进行安装，直接指定路径，这里没有检测到我们已经安装的，我们点击advanced手动指定目录

2. 使用vscode打开examples中的工程(esp-idf\examples\get-started\hello_world)
3. 插件安装完成后，底部可以选中串口
4. 设置烧写方式，快捷方式"ctrl+ ,"
5. 创建工程，选择芯片类型和工程，这个地方可能会卡住等一下
6. 编译工程，编译缓慢这个问题后面文章解决
7. 烧录，选择串口，进行烧录
8. 打开log监控，到这里已经完全结束

注意事项

• 请注意 ESP-IDF 和 ESP-IDF 工具的安装路径不能超过 90 个字符，安装路径过长可能会导致构建失
• Python 或 ESP-IDF 的安装路径中一定不能包含空格或括号。
• 除非操作系统配置为支持 Unicode UTF-8，否则 Python 或 ESP-IDF 的安装路径中也不能包括特殊字符（非 ASCII 码字符）

问题列表

cmake路径不在环境变量中

[Error: non zero exit code 2

ESP-IDF v4.3.3
'cmake' must be available on the PATH to use idf.py

	at ChildProcess.<anonymous> (\dist\extension.js:1:4499)
	at ChildProcess.emit (node:events:390:28)
	at ChildProcess.emit (node:domain:475:12)
	at Process.ChildProcess._handle.onexit (node:internal/child_process:290:12)]

添加环境变量即可

编辑不通过

删除工程目录下的build目录试试