Repolode
提交项目
espressif

espressif/esp-idf

乐鑫官方的 ESP32 等 SoC 嵌入式开发框架，支持 Windows、Linux 和 macOS。

在 GitHub 查看
Star
19,453
Fork
8,586
未关闭 Issue
1,807
最近提交
22小时前

这是什么？

ESP-IDF 是乐鑫官方为其 SoC 微控制器提供的开发框架，用于编写、配置、编译和烧录物联网设备固件。它支持 Windows、Linux 和 macOS，提供开发所需的工具链、库和构建系统。

开发者主要通过 idf.py 命令行工具工作：用 set-target 选择目标芯片，在基于文本的 menuconfig 菜单中调整配置，用 build 编译应用、引导程序和分区表，再通过串口用 flash 烧录设备。idf.py monitor 可显示串口输出，并能解析崩溃信息。

仓库的 examples 目录提供了示例工程。每个芯片系列和每个版本都有独立文档。2016 年前发布的 ESP8266 和 ESP8285 则由单独的 RTOS SDK 支持。

核心功能

  • 01通过 idf.py build 一条命令编译应用、引导程序和分区表。
  • 02提供 menuconfig 图形化文本菜单进行项目配置。
  • 03通过串口烧录固件并查看设备输出。
  • 04附带覆盖多款乐鑫芯片的示例工程。
  • 05支持 Windows、Linux 和 macOS，并提供环境安装与导出脚本。

适用场景

  • 为 ESP32 系列 Wi-Fi 和蓝牙物联网设备开发固件。
  • 在乐鑫开发板上快速验证嵌入式应用原型。
  • 构建并烧录带分区表的可 OTA 升级固件。

快速上手

  1. 1

    使用适合你 shell 的安装脚本设置构建环境

    ./install.sh
  2. 2

    在每个使用 ESP-IDF 的 shell 中加载环境变量

    source export.sh
  3. 3

    设置目标芯片，然后构建项目

    idf.py set-target <chip_name> && idf.py build
  4. 4

    将固件烧录到开发板并打开串口监视器

    idf.py -p PORT flash monitor

使用前须知

  • 使用前需要先安装主机构建依赖并运行安装脚本。
  • 不支持 ESP8266 和 ESP8285，这些芯片需使用单独的 RTOS SDK。

收录于专题

嵌入式开发与单片机工具

标签

#embedded#iot#firmware#microcontroller#esp32#build-system

常见问题

esp-idf 是什么？
乐鑫官方的 ESP32 等 SoC 嵌入式开发框架，支持 Windows、Linux 和 macOS。 ESP-IDF 是乐鑫官方为其 SoC 微控制器提供的开发框架，用于编写、配置、编译和烧录物联网设备固件。它支持 Windows、Linux 和 macOS，提供开发所需的工具链、库和构建系统。
esp-idf 可以免费使用吗？用的什么许可证？
esp-idf 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
esp-idf 还在维护吗？
活跃维护中。esp-idf 最近一次提交是在 2026年11月6日。
esp-idf 适合用来做什么？
为 ESP32 系列 Wi-Fi 和蓝牙物联网设备开发固件。 在乐鑫开发板上快速验证嵌入式应用原型。 构建并烧录带分区表的可 OTA 升级固件。
esp-idf 怎么安装和运行？
使用适合你 shell 的安装脚本设置构建环境: ./install.sh 在每个使用 ESP-IDF 的 shell 中加载环境变量: source export.sh 设置目标芯片，然后构建项目: idf.py set-target <chip_name> && idf.py build 将固件烧录到开发板并打开串口监视器: idf.py -p PORT flash monitor
在哪里获取 esp-idf？
源代码和安装说明在 GitHub 上：https://github.com/espressif/esp-idf

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目