Skip to main content

FAQ

Q: What connectors and cables should be used for the UART, sensor, CAN, I2C, RS485, and 5 V interfaces?

A: All of the above interfaces use HY2.0 connectors. Please select the matching cables based on the pin count of the interface:

  • UART interface: HY2.0 4P to Dupont male 4P cable
  • Sensor interface: HY2.0 3P to Dupont male 3P cable
  • CAN interface: HY2.0 2P to Dupont male 2P cable
  • I2C interface: HY2.0 4P to Dupont male 4P cable
  • RS485 interface: HY2.0 2P to Dupont male 2P cable
  • 5 V output interface: HY2.0 2P to Dupont male 2P cable

It is recommended to use the cables included with the product first.

Q: What connector is used for the battery interface?

A: The battery interface is a PH2.0 2P connector and only supports a single-cell 3.7V lithium battery. Do not confuse the PH2.0 battery cable with other HY2.0 peripheral interface cables.

Q: When connected to a USB port, the computer does not detect the COM port.

A: The USB interface and CAN interface on this device are shared and are switched via the extended IO pin EXIO5:

By default, this pin is pulled high to operate in CAN mode, so the computer cannot detect the USB COM port.

Pulling the EXIO5 pin low switches to USB mode, allowing the computer to detect the COM port normally (refer to the CAN-related example code for level control).

When flashing the program, first press and hold the BOOT button (do not release it), then reconnect the Type-C power cable to the USB port. After powering on, release the BOOT button.

Q: What is the difference between the onboard UART1 and UART2 interfaces? How should I choose which one to use?

A: Both UART1 and UART2 on the development board actually use the ESP32-S3's UART0 (IO43, IO44). The difference lies in their routing:

  1. The UART2 interface is directly routed from UART0 to a terminal block, making it convenient to connect external modules using wires.
  2. The UART1 interface is routed through the onboard CH343 chip for USB-to-serial conversion and connects to the computer via the Type-C port.
  3. You can switch between UART1 and UART2 using the onboard DIP switch. Slide the switch to the side corresponding to the desired interface.
Q: What is the total thickness of the product?

A: The distance from the bottom of the screen glass to the highest point of the white terminal block is approximately 18.30 mm. Please reserve appropriate space during mechanical design.

Q: The RS485_Test example program can only send data but cannot receive. How can I fix this?

A: RS485 communication issues can sometimes occur due to IDF version problems:

  1. For ESP-IDF environment: It is recommended to upgrade to v5.5.2.
  2. For Arduino environment: It is recommended to downgrade the esp32 package version to v3.0.7.
Q: ESP32-S3-Touch-LCD-7B CAN reception fails?

A:

  1. Re-open the COM port in the UCANV2.0.exe software and press the Reset button on the ESP32-S3-Touch-LCD-7B several times.
  2. Uncheck the "DTR" option in the serial debugging assistant.
Q: ESP32-S3-Touch-LCD-7B has no response after programming an Arduino program for RGB display?

A: If the screen shows no response after flashing the code, please check the configuration in Arduino IDE -> Tools:

  1. Select Flash Size as 16 MB.
  2. Enable PSRAM and select 8 MB OPI mode.
Q: Compilation fails or shows errors when flashing the Arduino RGB screen program on the ESP32-S3-Touch-LCD-7B?

A: Check if the required libraries are installed. Please refer to the Library Installation Guide.

Q: The libraries are all installed, but flashing the lvgl program reports an error missing lv_conf.h?

A: The library installation path may contain Chinese characters, preventing the library files from being found. Also, check if the lv_conf.h file is placed in the Arduino libraries folder.

Q: Why is there no display on the screen after successful Arduino flashing?

A: You can refer to the following steps to run the example for comparison:

  1. Before running the program, install the required libraries.
  2. Install libraries video reference.
  3. Run and flash the example programs.
Q: When compiling an example in Arduino IDE, I get a fatal error: esp_memory_utils.h: No such file or directory

A: Please install Arduino esp32 version ≥ v3.0.2 to resolve this issue.

Q: Can the CAN communication debugging tool send continuous frames?

A: Yes, you can also customize the frequency of consecutive frames. If the frequency is too high and causes the computer to lag, it may trigger bus errors.

Q: What if ESP-IDF programming fails?

A:

  1. Set the development board to download mode. Power off completely, press and hold the Boot button, then power on again and release the button to enter download mode. Re-flash the program, then reset to run.
  2. Try pressing the "fullclean" button in the status bar and recompile/flash. This cleans all compiled content, useful when compilation errors occur or the build environment gets corrupted.
Q: How to handle the situation when the AppData folder cannot be found?

A: The AppData folder is often hidden by default. You can change the settings to show hidden items:

  • Explorer -> View -> Check "Hidden items"
Q: How to view the COM port?

A:

  1. Press the Windows + R keys to open the "Run" dialog box, input devmgmt.msc and press Enter to open the Device Manager;
  2. Expand the "Ports (COM & LPT)" section. All COM ports and their current status will be listed here.
Q: What if the program takes extremely long to compile for the first time?

A: It is normal for the first compilation to be very slow. Please be patient and wait for it to complete.

Q: The program flashes successfully, but nothing is shown on the screen. How to solve this?

A: If the development board has a reset button, press it. If there is no reset button, please disconnect and reconnect the power.

Q: Program fails to flash when using a MAC device?

A: Install the MAC driver and then flash again.

Q: How to design a user interface with SquareLine Studio?
Q: How to port the provided lib libraries? Or how to develop my own LCD screen? How to drive it?

A: The display driver IC for this product is the ST7262, and the touch controller is the GT911. It is recommended to directly refer to the Arduino or ESP-IDF example programs for porting and secondary development.

Q: The compiler cannot find the common folder during compilation?

A: This is likely caused by an inconsistency between old and new IDF versions. Update to the latest IDF version.

Q: The screen appears to 'drift' when reconnecting to Wi-Fi. What should I do?

A: When driving an RGB screen with the ESP32-S3, some early IDF versions have an issue with overall LCD "drift". Recommendations:

  1. Use ESP-IDF release/v5.1 or later, or the corresponding Arduino-ESP32 version (v3.x or later).
  2. Refer to the official Espressif LCD FAQ entry regarding "ESP32-S3 driving RGB LCD screen drift" to confirm correct hardware connections, initialization timing, and RGB clock configuration. Detailed explanation can be found here: https://docs.espressif.com/projects/esp-faq/en/latest/software-framework/peripherals/lcd.html#why-do-i-get-drift-overall-drift-of-the-display-when-esp32-s3-is-driving-an-rgb-lcd-screen
Q: How to use LVGL on a board without touch?

A: If you are using a version without touch functionality, or if you temporarily do not need touch input, you can disable touch initialization and input device registration in the main function:

  1. Locate the touch controller initialization function (e.g., GT911 initialization) and the LVGL input device registration code in the example code.
  2. Comment out the entire section of code related to touch initialization and input event handling. Only keep the LCD display and LVGL rendering parts.

This will allow the LVGL graphical interface to run normally, but touch interaction will not be supported.

Q: Why can't the device be detected when plugged into the USB port?

A: The USB interface and CAN interface are shared and are distinguished by the EXIO5 pin of the extended IO. Pulling EXIO5 high selects the CAN interface, while pulling it low selects the USB interface.