# esp-idf-docs

**Repository Path**: Kevincoooool/esp-idf-docs

## Basic Information

- **Project Name**: esp-idf-docs
- **Description**: 淘宝酷世DIY ESP IDF入门教程
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-30
- **Last Updated**: 2026-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 酷世DIY · ESP-IDF 开发教程

> **文档总索引（含视频教程片单）** → [文档总目录与视频教程大纲](./docs/文档总目录与视频教程大纲.md)  
> 本页为观众入口；录制视频请以上述总目录的 **系列 A～P** 为准。

---

## 简介

ESP32 系列中文教程：从环境搭建、框架理解，到外设 / 联网 / 多媒体，以及 **Korvo S3**、**P4C5** 两块开发板的完整例程讲解。文档可按章节直接转为视频课。

| 开发板 | 例程规模 | 淘宝 |
|--------|----------|------|
| **ESP32-S3 Korvo 2 V3** | 60+ | [681702043224](https://item.taobao.com/item.htm?id=681702043224) |
| **ESP32P4-C5 4.3寸触摸屏** | 108 | [667230365314](https://item.taobao.com/item.htm?id=667230365314) |

- 推荐 **ESP-IDF v5.5.x**（P4C5 建议 5.5.3）
- **文档公开**；**完整例程**淘宝拍下后联系客服，**百度网盘**发放（`Korvo_Firmware/` 或 `P4_C5_4.3_Firmware/`）
- 工程路径**不要含中文**

---

## 三步开始

| 步骤 | 做什么 | 文档 |
|------|--------|------|
| 1 | 装 IDF、理解框架与工程目录 | [搭建环境](./docs/通用-搭建编译环境.md) → [框架构成](./docs/通用-ESP-IDF框架构成.md) → [工程结构](./docs/通用-ESP-IDF工程结构.md) |
| 2 | 拿例程、第一次烧录 | [例程开发流程](./docs/例程开发流程与公共组件.md) |
| 3 | 选你的板子跟路线走 | [Korvo 学习指南](./docs/Korvo例程学习指南.md) 或 [P4C5 学习指南](./docs/P4C5例程学习指南.md) |

完整片单与集号：[**文档总目录与视频教程大纲**](./docs/文档总目录与视频教程大纲.md)

---

## 文档命名规范

| 前缀 | 含义 |
|------|------|
| `通用-` | ESP-IDF API / 概念（不绑板） |
| `Korvo例程详解-` | Korvo 可烧录例程分步教程 |
| `P4C5例程详解-` | P4C5 可烧录例程分步教程 |
| `*学习指南` / `*开发板介绍` | 板级路线与硬件 |

---

## 快速入口

### Korvo S3

[Korvo开发板介绍](./docs/Korvo开发板介绍.md) · [Korvo例程学习指南](./docs/Korvo例程学习指南.md) · [热门例程详解 · Korvo](./docs/热门例程详解.md#korvo-s3-例程详解)

### P4C5

[ESP32P4-C5开发板介绍](./docs/ESP32P4-C5开发板介绍.md) · [P4C5例程学习指南](./docs/P4C5例程学习指南.md) · [P4C5在线组件](./docs/P4C5在线组件使用说明.md) · [热门例程详解 · P4C5](./docs/热门例程详解.md#p4c5-例程详解)

### 其他

[ESP32S3-SP-V4开发板介绍](./docs/ESP32S3-SP-V4开发板介绍.md) · [Korvo与P4C5例程对照表](./docs/Korvo与P4C5例程对照表.md)

### P4 专题

[P4C5专项测试 05.test](./docs/P4C5专项测试例程.md) · [P4C5-GMF 多媒体](./docs/P4C5-GMF多媒体例程.md)

---

## 文档分类目录

### 入门与构建

- [搭建编译环境](./docs/通用-搭建编译环境.md)
- [ESP-IDF 框架整体构成](./docs/通用-ESP-IDF框架构成.md)
- [ESP-IDF 工程结构（对比 Keil）](./docs/通用-ESP-IDF工程结构.md)
- [例程开发流程与公共组件](./docs/例程开发流程与公共组件.md)
- [Kconfig](./docs/通用-kconfig.md) · [menuconfig](./docs/通用-menuconfig.md)
- [分区表](./docs/通用-partition.md) · [创建组件](./docs/通用-创建组件.md)

### 外设 · 存储 · 网络 · 多媒体 · 扩展

详见 [文档总目录 · 第十一节](./docs/文档总目录与视频教程大纲.md#十一全部文档文件清单按文件夹排序)（含全部 `通用-*` 链接）。

### 例程实战

- [热门例程详解索引](./docs/热门例程详解.md)（Korvo / P4 分表，对接视频系列 K / P）

---

## 学习路线（摘要）

**Korvo**：环境 A 系列 → K00 验板 → B/C/D API 按需 → `Korvo例程详解-*` 逐个烧录  

**P4C5**：环境 A 系列 → P00 验板 → 理解 C5 Wi-Fi → `P4C5例程详解-*` → 在线组件自建工程  

细节与集号：[文档总目录与视频教程大纲](./docs/文档总目录与视频教程大纲.md)

---

## 注意事项

1. Korvo / P4 **例程 bin 不可互烧**；`idf.py set-target` 与板子一致  
2. 换工程必须 `cd` 到新目录；大改配置可删 `build/`  
3. 首次编译需联网（`managed_components`）  
4. P4C5 Wi-Fi 需等 C5 就绪（约 10～20 s）

---

## 联系

例程与技术支持：淘宝 **酷世DIY** · [Korvo](https://item.taobao.com/item.htm?id=681702043224) · [P4C5](https://item.taobao.com/item.htm?id=667230365314)

酷世DIY · Kevincoooool