FAQ
Q: Which screens are supported by the development board?
A: Please first check the component documentation to confirm compatible screen types: esp32_p4_platform
If you have requirements for adapting other screens or wish to inquire about support for specific screens, you can submit an issue via Waveshare's official after-sales support or the following address:
We will follow up and respond to your requests promptly.
Q: What is the current version of the ESP32-P4 chip?
A: The v1.3 version of the ESP32-P4 chip is the current mass‑produced version. The v3.x chips are not yet in mass production and are still at the sample stage from the original manufacturer.
Q: Which ESP-IDF version is recommended for the ESP32-P4?
A: Versions v5.5.1 to v5.5.4 are recommended.
Q: When flashing the board, I get this error: 'A fatal error occurred: bootloader/bootloader.bin requires chip revision in range [v3.1 - v3.99](this chip is revision v1.3). Use --force to flash anyway.' How do I fix it?
A: Change the chip revision in menuconfig. 
Q: How to use the Type‑A ports on the development board?
A: Of the four Type‑A ports, one is directly connected to the ESP32-P4, and the other three are connected to the CH334 HUB chip. You can use the jumper caps on the board to switch the ESP32-P4 between direct connection and connection to the CH334.
- When the jumper cap is placed on the HOST side, USB port 1 is enabled.
- When the jumper cap is placed on the DEVICE side, USB ports 2‑4 are enabled.

Q: How to flash firmware onto the ESP32-C6?
The ESP32-C6 ships with firmware by default. Please ensure the firmware you intend to flash is compatible and functional.
A: When powering on, pull C6_IO9 pin low (to put the C6 into download mode) , and also put the P4 into download mode. Then you can flash firmware to the C6 via the C6_U0RXD and C6_U0TXD pins.
Q: Are there example codes for other application scenarios?
A:
- During functionality testing, we have validated several features. Some applications, like using a Cat-4 module for network access or using P4's MIPI-DSI to expand the host screen, are progressing but not yet stable enough to release. Once these functionalities are refined, we will add examples to the wiki.
- If you have ideas or partially validated application scenarios, feel free to share them with us for feasibility assessment.
Q: Can I develop using PlatformIO or MicroPython?
A:
- Due to stability requirements, in order for PlatformIO to support ESP32-P4, it is also necessary for the PlatformIO community to support the Arduino-esp32 SDK V3.1x version
- During development, we tested MPY firmware for ESP32-P4, which can run some basic commands. However, this is just a preliminary verification; actual interface and peripheral applications are not yet adapted. Once fully adapted and stable, we will release ESP32-P4 usage examples in MicroPython.