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 文件里,有很多官方编写的例程,这些例程可以作为我们编写应用程序的模板,相当重要!