ESP32-P4-WIFI6-Touch-LCD-7B

7-inch 1024 × 600 touch display development board powered by ESP32-P4 and ESP32-C6

中文 · 🌐 Product Page · 📚 Documentation · 🧩 ESP-IDF Examples · 🔧 Arduino Examples · 📦 Firmware

This repository provides first-party ESP-IDF and Arduino examples, GitHub Actions validation, ESP-Brookesia firmware source, and a prebuilt factory firmware image for the Waveshare ESP32-P4-WIFI6-Touch-LCD-7B.

The board combines the multimedia capabilities of ESP32-P4 with an ESP32-C6 wireless coprocessor, a 7-inch capacitive touch display, camera and audio interfaces, USB, microSD, and industrial expansion interfaces. See the product page for ordering information and the official documentation for complete hardware and setup guidance.

Install ESP-IDF v5.5.5, then build the first-run board check:

cd examples/esp-idf/00_board_check
idf.py set-target esp32p4
idf.py build
idf.py -p PORT flash monitor

Replace PORT with the board's serial port. After the board check succeeds, continue with the Getting Started guide or choose an example from the table below.

See the complete example index for recommended learning order and hardware requirements.

The examples/arduino/ directory provides 12 Arduino-ESP32 3.3.11 sketches for the 7B display, GT911 touch, ESP32-C6 Wi-Fi path, camera, microSD, audio, RS485, and CAN/TWAI. Select ESP32P4 Dev Module, enable PSRAM, and choose the Chip Variant that matches the ESP32-P4 silicon revision. CI uses the Rev3.x postv3 variant by default. The Arduino integration does not assign GT911 INT or RST; it probes 0x5D and then 0x14 and keeps touch input in polling mode. See the Arduino example guide for menu settings, pin maps, and field-bus wiring requirements.

ESP32-P4 does not contain an integrated radio. Wi-Fi and Bluetooth are provided by the ESP32-C6 coprocessor over SDIO using ESP-Hosted. Keep the ESP32-C6 slave firmware compatible with the esp_hosted and esp_wifi_remote versions declared by each wireless project before changing or reflashing the coprocessor.

The ESP-IDF examples workflow discovers first-party projects and builds them for esp32p4:

The Arduino examples workflow compiles all 12 Arduino sketches with Arduino-ESP32 3.3.11 and the postv3 Chip Variant. It is compile coverage only and does not publish firmware ZIPs.

The lightweight discovery job classifies the complete pull-request diff before starting expensive builds. Documentation-only and governance-only changes run the repository checks without building examples; direct source changes select the affected example, and shared CI or configuration changes select all 18. All 46 example builds default to the Rev3.x rev3_x silicon profile without multiplying the matrix. firmware/brookesia remains outside that matrix and is not currently built or packaged by GitHub Actions. See Continuous Integration for routing and dispatch options. CI is compile evidence only, not hardware/HIL validation; no local schematic is held in this repository and the online BSP/application glue boundary remains in use.

The firmware/ directory keeps two different firmware surfaces:

• firmware/brookesia/ is an inventoried delivery-source project; it is not built by the default example CI.
• firmware/ESP32-P4-WIFI6-Touch-LCD-7B-FactoryOnly.bin is the existing prebuilt factory firmware image and is not a CI build output.

Factory BIN files are immutable delivery artifacts. Firmware-source changes and validation require an explicitly scoped firmware-maintenance workflow. See Firmware for delivery and flashing boundaries.

Use lowercase examples/esp-idf/ and examples/arduino/ paths. Generated build outputs such as build/, managed_components/, dependencies.lock, and local sdkconfig files are intentionally ignored.

• Official Product Documentation
• Getting Started
• Examples
• Arduino Examples
• Example Guide
• Firmware
• Continuous Integration
• Project Structure
• ESP32-P4 Revision Configuration

Contributions and reproducible issue reports are welcome. Include the board version, example path, ESP-IDF version, reproduction steps, expected behavior, actual behavior, and relevant serial logs.

• Contribution Guide
• Support Guide
• Open an Issue
• Technical Support

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