Skip to content

FAQ & Troubleshooting

Find quick answers to common questions about Hardware, Software, and Ordering.

Quick Search

Use the Search Bar (Ctrl+F) at the top to find specific errors, or check our GitHub Issues.

🚀 Quick Navigation

  • Software Development FAQ
    FAQ for Arduino, ESP-IDF, PlatformIO and LVGL...
    View FAQ

  • Hardware & Wiring FAQ
    Display types, pinouts, power requirements, and touch.
    View FAQ

  • Orders & Customization FAQ
    Bulk ordering, custom PCB/Screen, and warranty.
    View Policy

🔥 Top Frequently Asked Questions

These are the most common issues reported by users. Click to expand solutions.

1. Which library should I use: LVGL or Arduino_GFX?
  • Arduino_GFX: Best for simple drawing (circles, lines, text) and raw driver performance.
  • LVGL: The industry standard for complex UIs (Buttons, Charts, Animations). We recommend LVGL for professional products.
2. Do you support MicroPython or CircuitPython?

Yes, our hardware is fully compatible. While our official tutorials focus on C++, the community provides drivers for ST7701/ST7789 screens.

3. The screen is black but the backlight is on.
  1. Check PSRAM: For RGB screens, PSRAM must be enabled (Tools -> PSRAM -> OPI PSRAM).
  2. Check Library: Use Arduino_GFX for best compatibility.
  3. Check Resolution: Ensure code matches hardware (e.g., 800x480).
4. The touch function is not working or mirrored.
  1. I2C Address: GT911 usually uses 0x5D or 0x14.
  2. Cable: Ensure the 6-pin FPC is inserted fully (contacts facing down).
  3. Mirrored: Use touch.setRotation() or swap coordinates in LVGL indev_drv.
5. Compilation Error: esp_lcd_panel_io.h not found.

Update your ESP32 Board Package in Arduino IDE to version 2.0.14 or 3.0.x.

6. HDMI 'No Signal' on Raspberry Pi.

Force HDMI resolution in config.txt. See HDMI Guide.

7. How to export UI from SquareLine Studio?

Select Arduino protocol -> Export UI files -> Copy to project libraries -> Call ui_init().

💻 Software Development

Choose your preferred development framework. Each section below leads to a comprehensive setup and optimization guide.

📦 Development Frameworks

🛠️ Hardware & Wiring

Detailed hardware specs and wiring diagrams are located in our sub-pages.

Topic Quick Summary Full Link
Panel Types IPS (178° View) vs TN (Budget) Compare
Power Supply 5.0V Required. 3.3V is for Logic ONLY. Power
Interfaces RGB (40P/50P), SPI, I2C, HDMI, SDMMC Pinouts

⚡ Quick Tips

  • Flicker? Check if USB current is < 500mA. Try a 5V/2A adapter.
  • Logic Level? Logic pins are 3.3V. Connecting 5V directly to ESP32 IOs will damage it.

💼 Orders & Customization

Support Center

Submit GitHub Issue Contact Support Download Center