Skip to main content

User Guide

This section provides usage instructions for each functional example, helping users understand the onboard resources and interface usage of the ESP32-C5-Touch-LCD-2.8. Before running the examples, please prepare the following components:

Required Components​

  • ESP32-C5-Touch-LCD-2.8 ×1
  • TF Card ×1
  • Speaker ×1
  • Battery ×1

Wi-Fi Configuration​

  • Before use, turn on a Wi-Fi hotspot. The ESP32-C5 supports dual-band Wi‑Fi; you can choose either the 2.4 GHz or 5 GHz band according to your environment.
  • Wi‑Fi SSID: weather-wifi
  • Wi‑Fi Password: 12345678
  • Band: 2.4 GHz / 5 GHz. Note that some phones may not support 5 GHz hotspots. If you cannot connect, switch to a 2.4 GHz hotspot.
  • The Wi‑Fi SSID and password in the factory firmware are fixed. The hotspot you use must match the above configuration; otherwise, the device will not be able to connect.

Precautions​

⚠️ USB Download Precautions (Important)​

The development board uses USB for programming

If the port is not recognized, please enter Boot mode:

  1. Press and hold the BOOT button.
  2. Connect the USB cable to the computer
  3. Release the BOOT button.

After the download is complete, power cycle the board to run the program.

BAT_PWR Button Test​

  • After connecting the battery, the device can be powered directly by the battery and will turn on the screen (controlled by hardware circuitry, not software).
  • Long‑press the BAT_PWR button for about 2 seconds to power off. After power‑off, press the BAT_PWR button again to power on.

Firmware Download​

  • The example programs are located in the Firmware directory of the example package.

Example Overview​

  • The firmware uses the brookesia component to implement an APP‑style interface, including Settings, Photo Album, Music Player, 2048 Game, Weather, Drawing Board, Xiaozhi AI, Gravity Ball, Factory, and other apps.

App Example Introduction​

tip
  • To exit an app, swipe up from the bottom of the screen.
  • Swipe up from the bottom and pause in the middle of the screen to view recently running apps; swipe up again to close and terminate the APP process.

Settings APP​

  • Supports Wi‑Fi scanning and provisioning. Click wifi config in the Wi‑Fi interface to scan a QR code for network provisioning.

  • Allows adjusting display brightness, viewing TF card size, and checking the MAC address in the product info section.

XiaoZhi AI APP​

  • Tap the APP to launch the Xiaozhi AI application, which is consistent with the version adapted for the Xiaozhi official website and operates in the same way.
  • Long‑press the BOOT button to return to the brookesia interface.

Sensor APP​

  • Displays real‑time data from various sensors.
  • When you rotate the board, the gyroscope data changes accordingly; the RTC clock increments by the second.
  • When you cover the temperature/humidity sensor with your hand, the humidity value will gradually rise, while the temperature value usually changes little or remains stable.

Drawing Board APP​

  • Allows freehand drawing.

2048 APP​

  • Displays the current score and the best score in real time, and supports restarting the game with one tap.

MusicPlayer APP​

  • Supports playing MP3 audio files.
  • Before use, connect a speaker to the onboard speaker connector, then tap the play button to play the MP3 file stored in Flash.
  • Currently, the example only supports play and pause; switching tracks is not supported.

Weather APP​

  • After the device connects to the network, it will automatically fetch and parse the current day's weather information within a few seconds.
  • For secondary development, modify the ESP‑IDF example 06_wifi_weather as needed.

Gravity Ball​

  • This example demonstrates a gravity ball app based on the six‑axis IMU. The ball moves in real time according to the board's tilt angle and orientation changes.
  • Before use, place the board flat on a table and wait for the ball to finish loading before picking it up.
  • Tap the BOOT button to reset the ball's position.

Photo Album APP​

  • Supports displaying JPG images at 240×320 resolution or lower.

  • Emulates a digital photo album interface. This APP requires a TF card. Copy the photo folder from the example program Firmware/sdcard/ directory to the root of the TF card.