【获取官方资料】ESP-MDF 开发

0. 前言

  乐鑫官方的技术文档做得相当好，基本上我们按照文档一步一步操作，就可以很轻松地搭建好环境和开发应用程序。《ESP-MDF 开发》这一系列文章主要介绍如何基于 ESP-MDF 这一框架开发我们自己的 WiFi Mesh 应用程序，这一章节我先介绍介绍怎么获取官方的开发资料。

---

1. ESP-WIFI-MESH 通信协议

  实际开发过程中，我们经常会看不懂例程的源码，搞不清楚为什么组网流程或数据交互流程是这样的。出现这个问题的原因，我认为一是技术功底不到位、基础不扎实；二是对 ESP-WIFI-MESH 的概念认知还不够充分。

  所以这里我推荐大家一定要多看看 ESP-WIFI-MESH 通信协议，遇到问题想不通时，回过头来看看ESP-WIFI-MESH的一些基本概念，说不定就有思路了。

ESP-WIFI-MESH 协议介绍
https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/api-guides/mesh.html

---

2. ESP-MDF编程指南

编程指南里包含了我们学习 ESP-MDF 框架的所有资料，我们主要看以下这几个部分：

• 快速入门
• API指南
• API参考

ESP-MDF 编程指南
https://docs.espressif.com/projects/esp-mdf/zh_CN/latest/get-started/index.html

快速入门
  快速入门这个章节里，详细介绍了如何下载 ESP-MDF 源码，如何搭建开发环境以及如何编译运行一个例程。如果大家按照文档一步一步操作没出现问题的话，那么恭喜你，ESP-MDF 的开发环境搭建成功了。

API指南
  API指南主要描述技术细节和流程，例如如何配网、各节点如何在局域网内传输数据等。例如我想知道怎么给 ESP-WIFI-MESH 网络配置网络信息，那么我就可以仔细阅读 API指南>>配网模块这一章节内容，看看官方提供了什么解决方案，有了方案以后，也就有了解决问题的思路，接下来就可以按照自己的思路编写程序了。

API参考
  API参考消息描述了 ESP-MDF 框架里面的API接口、定义等，我们可以在这一章节里查询函数的具体用法， 是编写程序过程中必不可少的开发资料。

---

3. ESP-MDF 源码

  注意：源码里面的 README 文件一定要仔细看，当我们在上述的资料中找不到我们想要的答案时，可以去认真阅读阅读源码的 README 文件，说不定你想要的答案就藏在这些说明文档里面。

ESP-MDF源码地址
https://github.com/espressif/esp-mdf

另外，源码目录下的 examples 文件里，有很多官方编写的例程，这些例程可以作为我们编写应用程序的模板，相当重要！