Skip to main content

User Guide

To help users quickly understand the various functions of the product, we provide a series of test examples to familiarize customers with the use of each interface. Besides the ESP32-S3-Touch-LCD-1.54 host and its accompanying components, the following items are required to run the examples:

Required Components​

  • ESP32-S3-Touch-LCD-1.54 ×1
  • TF card ×1 (not required, needed only for TF card examples)

Assembly Guide

warning

When installing the battery, assemble the PC insulating sheet. It provides insulation and flame retardancy to isolate the battery from the PCB board.

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.

Firmware Download​

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

Firmware Flashing​

  • Unzip the software resource package (Flash_download_tool)
  • Open the flash_download_tool_3.9.7.exe software. Select ESP32-S3 and USB based on the development board's MCU and interface. ESP32-S3 and USB
  • Parameter Settings
    • ①. Select the COM port corresponding to the development board
    • ②. Select the highest baud rate, 1152000
    • ③. Click "..." to select the bin file from the ESP32-S3-LCD-1.54-Demo\Firmware or ESP32-S3-Touch-LCD-1.54-Demo\Firmware directory provided in the example package. Manually enter the download address "0x00", and check the box on the far left
    • ④. Start flashing
  • Flashing complete (the flashing process takes some time, please be patient)
  • Press the reset button and observe the result
warning

If it remains in the "Waiting for power-on sync" state, hold the "Boot" button and power cycle the device to enter download mode; this will resolve the issue.

Example Overview​

  • The firmware uses the Brookesia component, showcasing various applications in an APP style, including Settings, Photo Album, Music Player, Video Player, Spec_Analyzer, Squareline, Xiaozhi AI, Gravity Ball, etc. (Supported only by the touch version).

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​

  • Features Wi-Fi scanning and network configuration. Click WIFI on the interface, then wifi config to scan a QR code for network configuration

  • Allows adjustment of display brightness and volume

  • Displays the battery ADC voltage

  • Product about page, where you can view the MAC address

Photo Album APP​

  • Supports displaying JPG images at 240×240 resolution.

  • 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.

Convert Images​

  • You can customize image display using the following steps (requires some programming knowledge):

    • Select the image you want to display (e.g., test.bmp).

    • Install the ffmpeg tool.

    • Convert the image file to JPG format using ffmpeg:

      ffmpeg -i test.bmp -pix_fmt yuvj420p -q:v 1 -y test.jpg

    • Place the converted JPG file into the photo directory on the TF card.

    • Insert the TF card into the development board.

Music APP​

  • Supports MP3 music playback.

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

Video APP​

  • Supports video playback at 240x240 resolution.

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

Custom Video​

  • You can customize video clips using the following steps (requires some programming knowledge):

    • Select the video you want to play (e.g., a.mp4).

    • Install the ffmpeg tool.

    • Use ffmpeg to convert the video file to AVI format:

      ffmpeg -i a.mp4 -vcodec mjpeg -s 240x240 -r 30 -q:v 2 -acodec pcm_s16le -ar 44100 -ac 2 a.avi

    • Place the converted AVI file into the video directory on the TF card.

    • Insert the TF card into the development board.

E-Book APP​

  • Emulates an e‑book interface. This APP requires a TF card and a fiction directory containing .txt files to run properly.

Spec_Analyzer​

  • This example tests dual‑microphone audio capture; the spectrum changes with the dual‑microphone input.

Squareline​

  • This example demonstrates an LVGL example created with SquareLine Studio.

Gravity Ball​

  • This example demonstrates a Gravity Ball application based on the 6-axis inertial sensor. The ball moves in real-time on the screen as the device is tilted, following its orientation

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.

  • Double‑tap the BOOT button to return to the brookesia interface.