{"id":23819058,"url":"https://github.com/duruofu/esp32-guide","last_synced_at":"2025-04-13T15:36:05.853Z","repository":{"id":269802113,"uuid":"908495435","full_name":"DuRuofu/ESP32-Guide","owner":"DuRuofu","description":"ESP32入门教程，ESP32从初见到入门","archived":false,"fork":false,"pushed_at":"2025-04-12T02:55:16.000Z","size":29635,"stargazers_count":78,"open_issues_count":1,"forks_count":14,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T03:34:37.517Z","etag":null,"topics":["esp-idf","esp32","guide","tutorial"],"latest_commit_sha":null,"homepage":"https://duruofu.github.io/ESP32-Guide/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DuRuofu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-26T08:00:12.000Z","updated_at":"2025-04-12T02:55:20.000Z","dependencies_parsed_at":"2025-04-12T03:27:58.629Z","dependency_job_id":"3b9f9478-e3c8-4cc4-a5c8-3aa6465370a2","html_url":"https://github.com/DuRuofu/ESP32-Guide","commit_stats":{"total_commits":7,"total_committers":1,"mean_commits":7.0,"dds":0.0,"last_synced_commit":"df344bb44db55a31870edcd7f9bfa5f4656efacf"},"previous_names":["duruofu/esp32-guide"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DuRuofu%2FESP32-Guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DuRuofu%2FESP32-Guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DuRuofu%2FESP32-Guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DuRuofu%2FESP32-Guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DuRuofu","download_url":"https://codeload.github.com/DuRuofu/ESP32-Guide/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248737340,"owners_count":21153751,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["esp-idf","esp32","guide","tutorial"],"created_at":"2025-01-02T06:33:04.300Z","updated_at":"2025-04-13T15:36:05.839Z","avatar_url":"https://github.com/DuRuofu.png","language":"C","readme":"# ESP32从初见到入门（ESP32-Guide）\n\n![](attachments/20250202192226.png)\n## 许可协议：\n\n本仓库中的文本、代码、图片和视频均采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议— [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)。只要保持原作者署名和非商用，您可以自由地阅读、分享、修改分发本教程的文章和代码。\n\n## 在线阅读：\n\n-  [github-pages](https://duruofu.github.io/ESP32-Guide)\n- [DuRuofu的个人博客](https://blog.duruofu.top/docs/03.Embedded/ESP32/2025-ESP32-Guide/README.html)\n\n此外，文档配有对应的视频教程，可前往[B站（点击跳转）](https://www.bilibili.com/video/BV1fi6qY5EAC/?vd_source=ef5a0ab0106372751602034cdd9ab98e)浏览。\n\n## 前言：\n\n本教程基于**ESP-IDF-V5.3.2**，旨在记录并分享个人学习ESP32过程中的经验和心得，以帮助其他初学者快速上手ESP32开发。这是一份从初学者视角出发，整理了学习ESP32的一条较为合理的路径和方法的笔记汇编。\n\n文档内容基于对大量优质ESP32教程、官方文档以及实际项目实践的总结和理解，力求做到内容清晰、条理分明，既注重基础知识的巩固，也兼顾实战技能的提升。希望通过本教程，读者能少走弯路，从初学到实战开发，逐步掌握ESP32的开发技能。\n\n文档内容从基础到进阶，适合循序渐进地学习。如果您是初学者，可以按照章节顺序逐步学习；如果您已有一定的开发经验，可以直接跳转到感兴趣的部分阅读。同时，鼓励读者在学习过程中动手实践，以便更好地理解相关知识点。\n\n### 初衷：\n\n1. 一方面，本人在从零开始学习ESP32的过程中曾经走过很多弯路，踩过很多坑，现在回过头来觉得有更适合初学者学习的路径，故推荐给大家，希望后来人不要走了弯路。\n2. 另一方面，我始终认为，学习嵌入式，学习ESP32的秘诀是以实践促学习，也就是我们常说的费曼学习法—以输出倒逼输入。不要想着等我学会ESP32我就可以做什么，不妨换个思路，想想我现在需要做什么，做的这个东西需要用到ESP32的什么功能，然后点对点的去学习某个部分，这样学习完后可以立马投入使用，加深记忆。这份教程本身也算是我个人践行费曼学习法的实践过程。\n\n### 目录：\n\n![](attachments/目录.png)\n\n本教程共八个章节，三个阶段：基础（1-3），实践（4），进阶（5-10）\n\n其中基础章节一定要确保自己掌握，实践和进阶部分推荐按照个人需求进行选学。\n\n点击此处查看详细目录：[详细目录](./docs/docs/guide/目录.md)\n\n\u003cdiv STYLE=\"page-break-after: always;\"\u003e\u003c/div\u003e\n\u003cdiv STYLE=\"page-break-after: always;\"\u003e\u003c/div\u003e\n\n### 相关硬件及开发板：\n\n学习ESP32离不开一块趁手的开发板，笔者认为初学者学习ESP32的重点不在于一块全能的开发板，重点在于立刻开始学习，很多复杂的外设在初学时是用不到的。所以上手阶段推荐使用市面上常见的ESP32最小系统板，价格一般在20元左右，足够学习本教程除LVGL，特殊外设，实战演练以外的部分。\n\n此外，由于WiFi，蓝牙章节涉及到板间通信，需要使用两块开发板，所以推荐读者准备两块ESP32最小系统板。\n\n遵循以上原则，本教程大部分章节均使用下图所示的开发板，主控型号为ESP32-WROOM-32\n\n![](attachments/最小系统开发板.png)\n\n如果想进一步节省学习成本，还可以使用这种9.9元的ESP32-C3开发板（淘宝搜下面的图）：\n\n![](attachments/esp-c3开发板.png)\n\n至于LVGL，特殊外设，实战演练部分，会在教程章节单独推荐开发板或外设模块。\n\n\n## ## 参考链接\n\n- 孤独的二进制： https://space.bilibili.com/1375767826\n- Augtons正(单片机)： https://blog.csdn.net/m0_50064262/article/details/120250151\n- 乐鑫文档： https://docs.espressif.com/projects/esp-idf/zh_CN/release-v4.4/esp32c3/index.html\n- 第九个下弦月： https://space.bilibili.com/34165842?spm_id_from=333.999.0.0\n- Michael_ee： https://space.bilibili.com/505630520/fans/follow?tagid=529812\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fduruofu%2Fesp32-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fduruofu%2Fesp32-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fduruofu%2Fesp32-guide/lists"}