Skip to main content

User Guide

To help users quickly understand the various functions of the product, we provide a series of test demos for customers to learn how to use each interface. In addition to the ESP32-S3-Touch-LCD-7B main unit and its included cables, the following components are required to run the examples:

Component Preparation

Required Components

Precautions

  • When using, pay attention to the PCB antenna area. Avoid having other metal or plastic parts in contact with the PCB antenna.

  • The TF card can use SPI / MMC communication mode. Note that the SD_CS pin must be driven by EXIO4 of the CH422G.

  • The development board uses PH2.0 header to route peripheral pins such as ADC, CAN, I2C, RS485, and 5V. These can be connected to sensors and other peripherals using PH2.0 to 2.54mm male header adapter cables.

  • CAN and RS485 peripherals are connected to 120 Ω terminating resistors via DIP switches by default. To disconnect the terminating resistors, set the switches to the NC position.

  • The 7inch screen occupies most of the GPIOs. The development board uses a CH422G I/O expander chip for control functions such as reset, backlight on/off, brightness adjustment, and battery voltage reading.

  • Isolated I/O is controlled via the CH422G. For specific usage, refer to the IO_Test example. To understand the driver principles, please refer to the ESP32-S3-Touch-LCD-7B example code package or the relevant datasheet.

  • The PH2.0 lithium battery connector supports only a single-cell 3.7 V lithium battery.
    Do not connect multiple battery packs simultaneously for charging or discharging. A single-cell capacity of ≤ 2000 mAh is recommended.

  • The ESP32-S3-Touch-LCD-7B occupies the following I²C slave addresses.
    Do not use I²C devices with the same addresses:

         0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
    00: - - - - - - - - - - - - - - - -
    10: - - - - - - - - - - - - - - - -
    20: - - - - 24 - - - - - - - - - - -
    30: - - - - - - - - - - - - - - - -
    40: - - - - - - - - - - - - - - - -
    50: - - - - - - - - - - - - - - 5d -
    60: - - - - - - - - - - - - - - - -
    70: - - - - - - - - - - - - - - - -

⚠️ USB Download Precautions (Important)

Programming the development board via USB

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, press the RESET button to run the program.

Performance Notes (ESP-IDF & LVGL)

Currently, in the ESP-IDF v5.3 environment, running the LVGL benchmark example on a single core yields:

  • Average frame rate limit of approximately 17 FPS
  • Interface PCLK of approximately 30 MHz

The following options must be configured in menuconfig before compilation:

CONFIG_FREERTOS_HZ=1000
CONFIG_ESP_DEFAULT_CPU_FREQ_MHZ_240=y
CONFIG_ESPTOOLPY_FLASHMODE_QIO=y
CONFIG_ESPTOOLPY_FLASHFREQ_120M=y
CONFIG_SPIRAM_MODE_OCT=y
CONFIG_IDF_EXPERIMENTAL_FEATURES=y
CONFIG_SPIRAM_SPEED_120M=y
CONFIG_SPIRAM_FETCH_INSTRUCTIONS=y
CONFIG_SPIRAM_RODATA=y
CONFIG_ESP32S3_DATA_CACHE_LINE_64B=y
CONFIG_COMPILER_OPTIMIZATION_PERF=y

In the above configuration, CONFIG_ESPTOOLPY_FLASHFREQ_120M and CONFIG_SPIRAM_SPEED_120M must be consistent with the speed of the PSRAM and FLASH, respectively.

The following LVGL configuration items also help improve the frame rate (LVGL v8.3):

#define LV_MEM_CUSTOM 1
#define LV_MEMCPY_MEMSET_STD 1
#define LV_ATTRIBUTE_FAST_MEM IRAM_ATTR

For detailed LCD and LVGL performance information, please refer to the relevant performance documentation.