Skip to main content

ESP32-C5-Touch-LCD-2.8 Factory Firmware Usage

This section describes the functions and usage of each application (APP) in the ESP32-C5-Touch-LCD-2.8 factory firmware.

Function Description

The following instructions correspond to the 12-APP factory firmware, which supports 2.4 GHz and 5 GHz Wi-Fi. Please select the firmware according to the complete product model.

Parts Preparation​

  • ESP32-C5-Touch-LCD-2.8 ×1.
  • USB data cable ×1, used for power supply and flashing.
  • Speaker ×1, required for music playback, recording playback, and XiaoZhi AI.
  • TF card ×1, required for the music player and photo album; use the FAT32 format with a capacity of no more than 64 GB.
  • Matching battery ×1 (optional, for battery power).

First Use​

  1. Connect the speaker before powering on; if you need to play music or browse photos, insert a TF card with the files prepared in advance.
  2. Connect the development board to the computer using a USB data cable, or connect the matching battery for power.
  3. After system initialization completes, the APP desktop appears. Swipe left or right to switch pages; each page displays 4 APP icons.
  4. Complete the network setup as described below to use Weather, network time synchronization, and XiaoZhi AI.

TF Card Directory​

TF Card Directory Description

Place the JPG/JPEG images you want to browse in the photo folder in the TF card root directory, and place MP3 audio files in the music folder in the root directory.

TF card root directory
├── music
│ ├── music1.mp3
│ └── music2.mp3
└── photo
├── photo1.jpg
└── photo2.jpeg
  • music: Stores MP3 music files.
  • photo: Stores JPG/JPEG images; 240 × 320 pixel images are recommended to reduce memory usage.
  • The apps only read files in the folders above and do not scan subdirectories. After changing files or reinserting the card, reopen the corresponding APP.
  • Do not remove the card while the TF card is being read or written. Mic Test recordings are stored in memory and do not require a TF card.

After file preparation is complete, insert the TF card before powering on the development board.

Wi-Fi Setup​

The factory firmware supports connecting to 2.4 GHz and 5 GHz Wi-Fi, and you can connect to the network using either of the following methods. Saved networks take priority over the default hotspot.

Method 1: Connect to the Network via the Provisioning Page​

  1. Open "Settings" > "Wi-Fi setup", and the development board starts a provisioning hotspot.
  2. Use your phone to scan the QR code on the screen, or connect to the development board's hotspot using the hotspot name and password displayed on the screen.
  3. After connecting, the provisioning page opens; if it does not open automatically, visit the development board provisioning page in a browser.
  4. Enter the Wi-Fi name and password you want to connect to and submit; either a 2.4 GHz or 5 GHz network can be used.
  5. Check the connection status on the development board screen. After a successful connection, the network information is saved and the provisioning hotspot closes shortly afterward; exiting the provisioning page also closes the hotspot.

C5-2.8 Wi-Fi setup hotspot QR code

Mobile phone scanning the QR code to open the Wi-Fi provisioning page operation illustration

The right image is a phone provisioning page operation illustration borrowed from S3-3.5; the C5-2.8 actually supports 2.4 GHz and 5 GHz Wi-Fi.

Provisioning Hotspot Connection Changes

The development board's provisioning hotspot shares the wireless channel with the target network. When connecting to a 5 GHz network, the phone may disconnect from the provisioning hotspot; check the connection status on the development board screen, or reconnect to the provisioning hotspot.

Method 2: Connect to a Specified Hotspot​

When no other network is saved, the development board tries to connect to the following hotspot. You can enable your phone's hotspot before powering on, keeping the name and password exactly the same:

ItemSetting
Hotspot nameweather-wifi
Hotspot password12345678
Band2.4 GHz or 5 GHz

After connecting to a network with internet access, the desktop time synchronizes to Beijing time, and the Weather APP can retrieve Shenzhen weather. The desktop time shows --:-- until synchronization completes.

Firmware Download and Flashing​

For the download entry, see ESP32-C5-Touch-LCD-2.8 Resources and Documents. In the new project, the factory source code is located in examples/factory, and the merged firmware is located in the firmware directory. For flashing instructions, see the ESP32-C5-Touch-LCD-2.8 Firmware Flashing Tutorial.

USB Download Mode

If the port cannot be recognized during flashing, disconnect USB, press and hold BOOT, connect the development board to the computer, and then release BOOT. After the download completes, power cycle the device to run the program.

APP Usage Instructions​

Tap a desktop icon to enter the corresponding APP. Except for Display Test, which is exited by double-tapping, you can return to the desktop by swiping up from the middle of the bottom of the screen; some apps also provide a back button.

Only one APP runs at a time. Exiting Music, Mic Test, or AIChats stops the corresponding audio function, and Music does not continue playing in the background.

Display Test APP​

  • After opening, it cycles through red, green, blue, yellow, and white in order, with each color held for about 1 second.
  • You can check for display issues such as abnormal lines, local flicker, and missing pixels. Normal color switching is not abnormal flicker.
  • Double-tap anywhere on the screen to exit. After booting, the device enters the desktop, and you need to open this APP manually.

Red Display Test

Green Display Test

Blue Display Test

Yellow Display Test

White Display Test

Settings APP​

  • "Brightness": Adjusts the screen brightness.
  • "Volume": Adjusts the volume.
  • "Wi-Fi scan": Scans nearby networks; used for scanning only, not for connecting or changing saved networks.
  • "Wi-Fi setup": Starts the provisioning hotspot to configure the network via a phone.
  • TF card page: Displays capacity, free space, and file system information; tap "Refresh" to refresh.
  • "About": Displays the product model, firmware information, and MAC address.

The back arrow in the upper-left corner returns to the Settings home page from a subpage, and returns to the desktop from the Settings home page.

Settings home page

TF card capacity information

Wi-Fi scan results

AIChats APP​

  • Integrates the XiaoZhi AI chat feature. Connect to the network before use and complete activation as prompted on the screen.
  • Say "Ni Hao Xiao Zhi" or tap "Talk" to start a conversation, and tap "Stop" to stop.
  • Supports adjusting screen brightness and volume by voice.
  • Swipe up from the middle of the bottom of the screen to exit; no need to switch to or re-flash other firmware.

AIChats Xiaozhi AI

Touch Test APP​

  • Slide your finger on the screen to draw, with red strokes displayed at the touch positions.
  • You can cover the edges and four corners of the screen to check for broken touch or position offset.
  • Tap the back button in the upper-left corner or press BOOT to exit; you can also use the bottom swipe-up gesture to return to the desktop.

Touch Test touch drawing

GravityBall APP​

  • Before opening, place the development board flat and still, and wait about 2 seconds for calibration to complete.
  • Tilt the development board and the ball moves in the tilt direction, and can move to all edges of the screen.
  • Press BOOT to recalibrate; keep the development board flat and still during calibration.

GravityBall gravity ball

Photos APP​

  • Insert the TF card before powering on, and place JPG/JPEG images in the photo folder in the root directory.
  • Open the APP to browse images; swipe left or right to switch to the previous or next image, and images are scaled proportionally.
  • A single file must not exceed 1 MB; large images are also limited by decoding memory, so if loading fails, reduce the image to 240 × 320 pixels and try again.

Weather APP​

  • After connecting to the network, it retrieves and displays Shenzhen weather; tap the refresh button to retrieve the data again.
  • Before use, confirm that the connected network can access the internet; if Wi-Fi is connected but the weather service is unreachable, weather data may still fail to update.

Weather Shenzhen weather

Music APP​

  • Connect the speaker before powering on, and place MP3 files in the music folder in the TF card root directory.
  • After opening the APP, you can play, pause, and switch to the previous or next track.
  • The interface displays the track, playback time, and playback progress. Playback stops after exiting the APP.

Music music player

Sensor APP​

  • PCF85063 real-time clock: Displays the date and time of the hardware RTC (Real-Time Clock), updated every second.
  • SHTC3 temperature and humidity sensor: Displays the ambient temperature and relative humidity, updated about once per second.
  • QMI8658 six-axis sensor: Displays the three-axis acceleration and angular velocity; rotate or tilt the development board to observe the data changes.
  • If sensor reading fails, the corresponding data displays -- along with status information.
Desktop Time and RTC Time

The desktop displays the network-synchronized Beijing time, while Sensor displays the hardware RTC time; the two are independent. Network time synchronization does not automatically overwrite the hardware RTC, and the two times are not required to match.

Sensor real-time clock, six-axis, and temperature/humidity data

2048 APP​

  • Swipe up, down, left, or right to merge tiles with the same number; the interface displays the current score and best score.
  • Tap "New" to restart. After exiting and re-entering, the current board continues; progress is not retained after power loss.

2048 game

Mic Test APP​

  • Speak into the onboard microphone and observe the volume bar and value changing with the sound.
  • Tap "Record" to start recording, tap "Stop" to stop, and tap "Play" to play back; connect the speaker before using playback.
  • A single recording lasts up to 10 seconds, and recordings are temporarily stored in memory, require no TF card, and are cleared after exiting the APP.
  • While monitoring the volume bar, the microphone sound is not played through the speaker in real time.

Mic Test microphone recording test

Button Test APP​

  • This APP only tests BOOT (GPIO28) and does not include BAT_PWR button testing.
  • Release BOOT first, then short-press and release it once. The status changes with pressing and releasing, and the count increases by 1 after one operation, displaying "PASS".
  • After the test passes, it displays "1 / 1 button passed"; tap "Test again" to reset and retest.

Button Test BOOT button test