ESP32-P4-WIFI6-Touch-LCD-X

The ESP32-P4-WIFI6-Touch-LCD-X series combines an ESP32-P4 multimedia processor, an ESP32-C6 wireless coprocessor, and a capacitive MIPI-DSI touch display in an all-in-one HMI platform. The family is available with 7, 8, and 10.1-inch displays for smart-home terminals, industrial controls, edge computing, multimedia, and interactive UI applications.

This repository contains first-party ESP-IDF and Arduino examples, factory flashing images, and board schematics. Refer to the official product page for current specifications and package contents.

All three variants use a two-lane MIPI-DSI display interface and a GT9271 10-point capacitive touch controller. Display orientation is configurable in software.

For GPIO assignments and circuit details, use the repository schematics:

• ESP32-P4-WIFI6-Touch-LCD-X schematic
• ESP32-P4-Connect-Adapter schematic

1. Choose the product variant that matches your display.
2. Follow the official ESP-IDF setup and example guide.
3. Open a project under examples/esp-idf/, set the target to esp32p4, and review its README or configuration options. The examples default to ESP32-P4 Rev3.x; use the explicit silicon-revision profile only for older Rev1.3 hardware.
4. For display examples, select the correct panel under Board Support Package (ESP32-P4) > Display > Select LCD type in menuconfig.
5. Build, flash, and monitor the selected example using the ESP-IDF tools described in the official documentation.

Some multimedia examples require additional hardware or media files. Review the example-specific notes before flashing.

examples/arduino/ provides 10 first-party sketches for display, touch, text, LVGL 9, hosted Wi-Fi analysis, camera preview and ISP tuning, MicroSD, audio playback, and microphone capture. They follow the LCD-5 bundled-library layout: GFX_Library_for_Arduino, displays, LVGL 9.3.0, and lv_conf.h. All 10 sketches are compile-checked for LCD-7, LCD-8, and LCD-10.1. See the Arduino examples guide for the complete sketch list, peripheral assignments, exact Arduino-ESP32 3.3.11 FQBN, and variant build command.

The display reset is GPIO27. Touch INT and RST are intentionally left as GPIO_NUM_NC; the library probes 0x5D followed by 0x14, binds the actual responding address, and uses polling only. A compile result does not verify that display or touch behavior on hardware.

The ESP-IDF examples workflow discovers the 12 first-party projects and builds each one for esp32p4 with ESP-IDF v5.5.5 and v6.0.2. The six display examples are expanded for the 7-inch, 8-inch, and 10.1-inch display variants, producing 48 source-build rows in a full run. Only 04_wifistation and 05_sdmmc use their non-empty sdkconfig.ci overlay; display rows also use their selected LCD overlay. ESP-IDF v5.5.5 rows compile only; the 18 v6.0.2 display rows upload source-built CI artifacts retained for 14 days. All 48 rows and all 18 downloadable example artifacts use the rev3_x profile. Rev1.3 and Rev3.x are mutually exclusive ESP-IDF build targets; see ESP32-P4 Silicon Revisions before building for an older board. The separate documentation workflow applies a complete Markdown gate for ownership, bilingual companions and language-correct links, homepage symmetry, local links, and public-text privacy. It also verifies docs-only scope, so the discovery job remains visible for every pull request while documentation-only and factory-firmware-only changes select no example builds. A fixed-name ESP-IDF CI gate combines discovery with any selected matrix builds, so the workflow has one stable result for branch-protection rules.

The Arduino examples workflow compiles the 10 Arduino sketches with Arduino CLI 1.5.1 and Arduino-ESP32 3.3.11 for all three display variants (30 rows). It uses the postv3 ESP32-P4 board profile, is compile-only, and does not publish firmware or downloadable build artifacts. 05_GFX_ESPWiFiAnalyzer requires compatible hosted firmware on the ESP32-C6 coprocessor when run on hardware; see hosted Wi-Fi compatibility.

Factory binaries are excluded from source-build discovery. See Component Ownership for the boundary between local board glue, embedded upstream code, and managed-component candidates. The 11 phone-style example is compile-covered only; its 7-inch hardware/UI has not been verified and this repository does not add a 720x1280-specific stylesheet.

The default ESP-Brookesia firmware source is available under firmware/brookesia/. The Rev3.x merged factory images built from that source are:

• ESP32-P4-WIFI6-Touch-LCD-7-FactoryOnly-260915.bin
• ESP32-P4-WIFI6-Touch-LCD-8-FactoryOnly-260820.bin
• ESP32-P4-WIFI6-Touch-LCD-10.1-FactoryOnly-260820.bin

Use only the image that matches your hardware and ESP32-P4 Rev3.x. Superseded fixed-name FactoryOnly images have been removed; only the current dated images are kept. These binaries are separate from source-built CI artifacts. See the official resources and documents for the flash download tool and related materials.

Contributions and reproducible issue reports are welcome. Include the product variant, hardware revision if known, example path, ESP-IDF version, reproduction steps, expected behavior, actual behavior, and relevant serial logs.

• Open an issue
• Contributing guidelines
• Support
• Waveshare support
• English documentation
• 中文文档

This repository is licensed under the Apache License 2.0. See LICENSE.txt.