使用说明
ESP32-S3-LCD-1.85 目前提供 Arduino IDE 和 ESP-IDF 两种开发工具和框架,提供了灵活的开发选择,你可以根据项目需求和个人习惯选择适合的开发工具。
开发工具介绍
Arduino 通常更容易上手,对初学者和爱好者更加友好。ESP-IDF 提供更完整的开发工具链和更细粒度的系统控制,适合复杂项目或对性能有较高要求的应用。
-
Arduino IDE 是一款便捷灵活、易于上手的开源电子原型平台。无需太多基础知识,简单学习后即可快速开发。Arduino 拥有庞大的全球用户社区,提供海量开源代码、项目示例和教程,以及丰富的库资源,封装了复杂功能,让开发者能够快速实现各种功能。您可以参考 Arduino IDE 开发环境搭建教程 完成初始设置,教程中同时提供了相关示例程序供参考。
-
ESP-IDF 全称 Espressif IoT Development Framework,是乐鑫科技为 ESP 系列芯片推出的专业开发框架。它基于 C 语言开发,包含编译器、调试器、烧录工具等,支持命令行或集成开发环境(如 Visual Studio Code 配合 Espressif IDF 插件)开发,插件提供代码导航、项目管理、调试等功能。我们推荐使用 VS Code 进行开发,具体配置过程可参考 ESP-IDF (VS Code) 开发环境搭建教程,教程中同时提供了相关示例程序供参考。
器件准备
- ESP32-S3-LCD-1.85 x1
- 含 MP3 文件的 SD 卡 x1
- USB 线 type A 公口 转 Type C 公口 x1
- 2030 腔体喇叭 8Ω 2W x1

注意事项
- 请注意,电脑用户名必须是英文,用户名为中文会导致编译出错
- 在通过提供的示例启用所有板载设备时,若想继续使用板载蓝牙设备,建议使用其他内存占用较小 的音频库文件(否则会导致 SRAM 占用过大)
- 开发板使用 USB 下载程序,如果出现无法识别到端口,请进入 boot 模式(摁住 boot 按键后,再连接电脑,然后松开 boot 按键),下载程序后,按 RESET 按键运行程序
- Arduino 上的 ESP32 3.0.2 基于 ESP-IDF v5.1 开发,与此前基于 ESP-IDF V4.X 有较大差异,在进行以下操作后,原先可以正常运行的程序可能需要进行一些调整才可使用
注意
在操作前,建议先浏览目录,快速了解文档结构。为顺利操作,请仔细阅读 FAQ,提前了解可能的问题。文档中所有资料均提供超链接,方便下载。