Skip to main content

Instructions for Use

The ESP32-S3-LCD-1.85 currently provides two development tools and frameworks, Arduino IDE and ESP-IDF, offering flexible development options. You can choose the appropriate development tool based on your project requirements and personal preferences.

Development Tools​

Arduino is generally easier to get started with and more beginner‑friendly for hobbyists. ESP‑IDF offers a more complete development toolchain and finer‑grained system control, making it suitable for complex projects or applications with higher performance requirements.

  • Arduino IDE is a convenient, flexible, and easy-to-use open-source electronics prototyping platform. It requires minimal foundational knowledge, allowing for rapid development after a short learning period. Arduino has a huge global user community, providing a vast amount of open-source code, project examples, and tutorials, as well as a rich library ecosystem that encapsulates complex functions, enabling developers to implement various features rapidly. You can refer to the Working with Arduino to complete the initial setup, and the tutorial also provides related example programs for reference.

  • ESP-IDF, short for Espressif IoT Development Framework, is a professional development framework launched by Espressif Systems for its ESP series of chips. It is based on C language development and includes compilers, debuggers, flashing tools, etc. It supports development via command line or integrated development environments (such as Visual Studio Code with the Espressif IDF plugin), which provides features like code navigation, project management, and debugging. We recommend using VS Code for development. For the specific configuration process, please refer to the Working with ESP-IDF. The tutorial also provides relevant example programs for reference.

Required Components​

  • ESP32-S3-LCD-1.85 x1
  • TF card with MP3 files x1
  • USB cable, Type‑A male to Type‑C male x1
  • 2030 speaker 8Ω 2W ×1

ESP32-S3-LCD-1

Precautions​

  • Please note that the computer username must be in English; a Chinese username will cause compilation errors.
  • When enabling all onboard devices through the provided examples, if you want to continue using the onboard Bluetooth device, it is recommended to use another audio library file with lower memory usage (otherwise SRAM usage will be too high).
  • When the development board uses USB to download programs, if the port cannot be recognized, please enter boot mode (hold down the BOOT button, then connect to the computer, and then release the BOOT button). After downloading the program, press the RESET button to run the program.
  • ESP32 3.0.2 on Arduino is based on ESP-IDF v5.1, which differs significantly from the previous ESP-IDF V4.X. After performing the following operations, programs that previously ran normally may require some adjustments to be usable.
warning

Before operating, it is recommended to browse the table of contents to quickly understand the document structure. To ensure a smooth operation, please read the FAQ carefully to understand potential issues in advance. All materials in the document are provided with hyperlinks for easy download.