Google Chat: zj734465502@gmail.com
+86-0755-88291180
sales01@spotpear.com
dragon_manager@163.com
services01@spotpear.com
manager01@spotpear.com
WhatsApp:13246739196
ESP32-P4-NANO is a dual-core RISC-V high-performance development board based on ESP32-P4 chip designed by Waveshare. It supports a wide range of human-computer interfaces, including MIPI-CSI (Integrated Image Signal Processor, ISP) and MIPI-DSI interfaces, as well as common peripherals such as SPI, I2S, I2C, LED PWM, MCPWM, RMT, ADC, UART, and TWAI™. It also supports USB OTG 2.0 HS, Ethernet, and SDIO Host 3.0 for high-speed connectivity. The chip integrates a digital signature peripheral and a dedicated key management unit to ensure its security. ESP32-P4-NANO is specifically designed for high-performance and high-security applications, fully meeting the higher demands of embedded applications in areas such as support for human-machine interfaces, edge computing capabilities, and IO connectivity characteristics.
1. ESP32-P4NRW32 2. ESP32-C6-MINI-1 3. Display screen interface 4. Camera interface 5. Type-C interface 6. USER-LED 7. BOOT button | 8. RESET button 9. PoE module power supply interface/external power supply interface 10. RTC holder 11. SMD microphone 14. 100MB RJ45 network port 15. Speaker interface 16. GPIO interface |
This tutorial is designed to guide users to set up a software environment for ESP32-P4 hardware development, and show how to use the ESP-IDF configuration menu and compile and download the firmware to the ESP32-P4 development board through simple examples.
ESP-IDF (Espressif IoT Development Framework) is an open-source IoT development framework launched by Espressif specifically for the development of its ESP32 series chips. ESP-IDF provides the necessary tools and libraries to build IoT applications, including Wi-Fi, Bluetooth, peripheral drivers, file systems, network protocol stacks, encryption, security, and real-time operating systems (FreeRTOS).
The following description only applies to the VSCode + ESP-IDF environment
The best way to learn a language or development environment is to start from the basics. This section will provide a detailed guide on how to create projects, develop from existing projects, and include embedded classic tutorials such as HelloWorld and the usage of common interface I2C
├── CMakeLists.txt ├── main │ ├── CMakeLists.txt │ └── main.c └── README.md
CMakeLists.txt
.idf.py add-dependency <componetsName>
to add online components to the project, which generates a idf_component.yml
file for managing components.CMake
first reads the content of the top-level CMakeLists.txt
in the project directory to read the build rules and identify the content to be compiled. When the required components and demos are imported into the CMakeLists.txt
, the compilation tool CMake
will import each content that needs to be compiled according to the index. The compilation process is as follows:When we open an ESP-IDF project, the environment is automatically loaded at the bottom. For the development of ESP32-P4-NANO, the bottom toolbar is also very important, as shown in the figure:
esp32p4
as the target chipAfter understanding Description of bottom toolbar of VSCode user interface, the HelloWorld project allows you to quickly get started and understand the basic projects of the ESP32 development environment. It demonstrates how to use ESP-IDF to create a basic application, and covers the ESP32 development process, including compilation, flashing, and monitor debugging steps.
HelloWorld
, set the target port and chip type (Note: There is a loading action in the lower right corner when the chip type is selected, indicating that ESP-IDF is executing the command idf.py set-target esp32p4
. It needs to pull the architecture package environment corresponding to the chip from the package manager, which may take some time. Please wait patiently. If you perform build or other operations at this time, there will be errors!!!)app_main
main function in the code, which determines the print content output through conditional judgment, and adds a loop at the end to achieve 10s restart of the chip.app_main
function is the entry point for user applications in the ESP-IDF (Espressif IoT Development Framework) development framework. It is the core function of the ESP-IDF project and is equivalent to the main function in the standard program of the C language. In ESP32 development, app_main
function is the first task scheduled by the real-time operating system (FreeRTOS), which is the starting point for the execution of the user's code.I2C is a commonly used serial communication bus, which can communicate through two lines, one data cable (SDA, Serial Data) and one clock cable (SCL, Serial Clock), and supports multi-master and multi-slave mode. On the ESP32-P4, there are two I2C bus interfaces. The chip internally uses a GPIO exchange matrix to configure the use of any GPIO pins. This feature allows us to freely use any GPIO as an I2C pin control. Of course, the ESP32-P4 I2C supports both Slave and Master modes. Below, we primarily use the I2C host (Master) mode for ESP32-P4 to start communication, control, send data requests or receive data from the slave devices (which can be sensors with any I2C interface). The I2C pins of ESP32-P4-NANO use SCL(GPIO8)
and SDA(GPIO7)
by default
In ESP-IDF, the I2C bus requires the configuration specified by i2c_master_bus_config_t
:
i2c_master_bus_config_t::clk_source
selects the source clock for the I2C bus, using the default I2C clock source (usually the default clock source) is simply set to I2C_CLK_SRC_DEFAULT
i2c_master_bus_config_t::i2c_port
sets the I2C port used by the controller, as explained above, the ESP32-P4 has two I2C ports. When two different I2C interfaces need to be enabled simultaneously, this needs to be utilized to distinguish between themi2c_master_bus_config_t::scl_io_num
sets the GPIO number of the serial clock bus (SCL), which is 8 on ESP32-P4-NANOi2c_master_bus_config_t::sda_io_num
sets the GPIO number for the serial data bus (SDA), which is 7 on the ESP32-P4-NANOi2c_master_bus_config_t::glitch_ignore_cnt
sets the Glitch Period for the Master Bus, and if the Glitch Period on the line is smaller than this value, it can be filtered out. Typically, this value is set to 7i2c_master_bus_config_t::enable_internal_pullup
enables internal pullups, on the ESP32-P4-NANO, there is already an additional I2C pullup, no need to enable internal pullupsAs described above, the I2C configuration is:
i2c_master_bus_config_t i2c_bus_config = { .clk_source = I2C_CLK_SRC_DEFAULT, .i2c_port = I2C_NUM_0, .scl_io_num = 8, .sda_io_num = 7, .glitch_ignore_cnt = 7, .flags.enable_internal_pullup = false, };
i2c_tools
the project, select the COM port and chip model, click to enter the settings. This will open a new tab: SDK Configuration editor, also known as menuconfig. Directly search for I2C in the search bar. The content has already been retrieved, and the SCL GPIO Num and SDA GPIO Num in the demo are already corresponding to SCL(GPIO8)
and SDA(GPIO7)
This example demonstrates the basic usage of Ethernet driver and esp_netif. The initialization of the Ethernet driver is included in a separate subcomponent of the project to clearly distinguish between the initialization of the driver and the initialization of the esp_netif. The workflow for this example is as follows:
TXD[1:0]
: Sending data cable, controlled by GPIO34 and GPIO35RXD[1:0]
: Receiving data cable, controlled by GPIO30 and GPIO29TX_EN
: Sends an enable signal, controlled by GPIO49CRS_DV
: Carrier detection and data valid signals, controlled by GPIO28REF_CLK
: Reference clock, controlled by GPIO50, 50MHz generated by a 25 MHz passive crystal oscillator connected outside the PHY through frequency doublingMDIO
and MDC
: Manage data interface for Ethernet (control and configuration of the PHY) is controlled by GPIO52 and GPIO31RESET
: Control IP101GRI reset, controlled by GPIO51ethernetbasic
project, select the appropriate COM port and chip model, click on the to enter the settings. This will open a new tab: SDK Configuration editor, also known as menuconfig. Directly search for ETH in the search bar, you will find that the content has already been retrieved, and correspond to the parameters in the following figure:espressif
is connected, and the ESP32-P4-NANO is connected to the network.The ESP32-P4-NANO features a 4-Wire SDIO3.0 card slot for off-chip memory expansion
In ESP-IDF, use sdmmc_host_t
and sdmmc_slot_config_t
settings to configure the default 20MHz communication frequency and 4-wire width communication, as follows:
sdmmc_host_t host = SDMMC_HOST_DEFAULT(); sdmmc_slot_config_t slot_config = SDMMC_SLOT_CONFIG_DEFAULT();
In designs that support 40 MHz communication, you can adjust the max_freq_khz field in the sdmmc_host_t structure to increase the bus frequency:
sdmmc_host_t host = SDMMC_HOST_DEFAULT(); host.max_freq_khz = SDMMC_FREQ_HIGHSPEED;
The SDMMC 4-wire connection on the ESP32-P4-NANO should be defined as:
sdmmc_slot_config_t slot_config = SDMMC_SLOT_CONFIG_DEFAULT(); slot_config.width = 4; slot_config.clk = 43; slot_config.cmd = 44; slot_config.d0 = 39; slot_config.d1 = 40; slot_config.d2 = 41; slot_config.d3 = 42; slot_config.flags |= SDMMC_SLOT_FLAG_INTERNAL_PULLUP;
sdmmc
project, select the COM port and chip model, because the demo project defines the pin as a macro, so you need to configure it, of course, you can also directly fill in the pin value. Click to enter the settings, here a new tab will open: SDK Configuration editor, which is also known as menuconfig. We directly search for sd in the search bar, see that the content has been retrieved at this time, and the demo configuration has been configured, check the default initialization and create the demo file by default:The ESP32-P4 does not come with WIFI/BT capabilities by itself, whereas the ESP32-P4-NANO extends its WIFI functionality by connecting to an ESP32-C6 module via SDIO. The ESP32-C6 acts as a Slave, supporting the ESP32-P4 as the Host utilizing the WIFI 6/BT 5 features through SDIO via a series of instruction sets. By adding two components, seamless use of esp_wifi
is achieved.
// In a WIFI project, add the following two components through the ESP-IDF component management tool idf.py add-dependency "espressif/esp_wifi_remote" idf.py add-dependency "espressif/esp_hosted"
wifistation
project to add componentsidf_component.yml
in the main folder of the project, which is used to manage project components, as explained in the ESP-IDF Project Catalog sectionespressif/esp_hosted: "*"
and espressif/esp_wifi_remote: "*"
have been added. They are added to the project as you build itI2S (Inter-IC Sound) is a digital communication protocol for transmitting audio data. I2S is a serial bus interface that is primarily used for digital audio data transmission between audio devices, such as digital audio processors (DSPs), digital-to-analog converters (DACs), analog-to-digital converters (ADCs), and audio codecs.
The ESP32-P4 includes 1 I2S peripheral. By configuring these peripherals, the sample data can be input and output with the help of an I2S driver. ESP32-P4-NANO board integrates the es8311 Codec chip and the NS4150B power amplifier chip combination. The I2S bus and pin distribution are as follows:
Function pin | ESP32-P4-NANO pin |
---|---|
MCLK | GPIO13 |
SCLK | GPIO12 |
ASDOUT | GPIO11 |
LRCK | GPIO10 |
DSDIN | GPIO9 |
PA_Ctrl (Power amplifier chip enable pin, active high) | GPIO53 |
The ESP32-P4-NANO es8311 driver uses ES8311 components. It can be added during usage through the IDF Component Manager.
idf.py add-dependency "espressif/es8311"
i2scodec
project to add componentsidf_component.yml
in the main folder of the project, which is used to manage project components, as explained in the ESP-IDF Project Catalog sectionthe espressif/es8311
component has been added, and it will be added to the project when you build itecho
mode is set in the settings, the audio will be recorded by the microphone and output by the speakersESP32-P4-NANO uses the ESP32-P4NRW32 chip with the following new features:
MIPI-DSI image processing can also be processed using a 2D-DMA controller, which supports PPA and JPEG encoding/decoding peripherals
idf.py add-dependency "waveshare/esp_lcd_jd9365_10_1"
to add components to your project.esp32p4
core, and you can directly click to compile, flash, monitor. Upon completion, you can see that the screen has lit up to refresh the color bar:This example shows how to use the esp_driver_cam component to capture the camera sensor signal and display it through the DSI interface. This example utilizes the ESP camera sensor driver esp_cam_sensor
to capture camera sensor signals through the CSI interface and display them via the DSI interface.
esp32p4
core. Next, you can directly compile, flash, and monitor through clicking . Upon completion, you can view the screen lighting up and refreshing the camera's captured images. Here is a demonstration of the ESP32-S3-Touch-AMOLED-1.8This example demonstrates how to use the ESP32-C6 on the ESP32-P4-NANO board as a slave, enabling the ESP32-P4 to drive the IP101 network registration and then realizing the WiFi AP function through the ESP32-C6. The working principle is as follows in the diagram
esp32p4
core, and you can directly click to compile, flash, monitor. When you're done, you can connect the internet cable and check the WiFi to surf the Internet. If there is an optional Luckfox POE Module, it can be connected to a PoE switch to get power directly to the Internet.This example shows that the ESP32-P4 displays LVGL images through the MIPI DSI interface, which fully demonstrates the powerful image processing capabilities of the ESP32-P4
idf.py add-dependency "waveshare/esp_lcd_jd9365_10_1"
to add components to your project.esp32p4
core, and you can directly click to compile, flash, monitor. Upon completion, you can view the screen:
This example is based on ESP_Brookesia and shows an Android-like interface with many different applications. This example uses the board's MIPI-DSI interface, MIPI-CSI interface, ESP32-C6, TF card, and audio interface. Based on this example, you can create a use case based on ESP_Brookesia to efficiently develop multimedia applications.
idf.py add-dependency "waveshare/esp_lcd_jd9365_10_1"
to add components to your project.esp32p4
core, and you can directly click to compile, flash, monitor. Upon completion, you can view the screen:This section features third - party project resources. We merely provide links and bear no responsibility for content updates or maintenance. Thank you for your understanding.
That Project-StickiNote: A Sticky Notes App for ESP32-P4 & MIPI DSI!
You can subscribe to the repository, just open an issue, explain your requirements clearly, engineers will be the first time to evaluate the requirements, if there is any progress and update the repository, and you can also joke about the product, share your experience, and put forward your ideas. ESP32-display-support
1. In the mipi_dsi_bus.c driver file of the ESP-IDF, the signal escape clock frequency for MIPI_DSI_DEFAULT_ESCAPE_CLOCK_FREQ_MHZ is set to 10MHz. However, in practical testing, this escape speed clock frequency is too low. Since the MIPI communication quality varies for different screens, in this scenario, it can lead to blocking during high-speed MIPI-DSI communication on the ESP32-P4, causing the screen to fail to function properly. There are two solutions:
esp-idf/components/esp_lcd/dsi/esp_lcd_mipi_dsi_bus.c
defines #define MIPI_DSI_DEFAULT_ESCAPE_CLOCK_FREQ_MHZ 10
, and just modify this value to 20.1. This issue occurs when using the VS Code plugin. In some cases, the ESP-IDF installed by the VS Code plugin may have a bug. The current solution is to use the IDF tool directly for compilation and flashing.
1. The current chip is version EC01. This version has not undergone ADC calibration, so the use of ADC functionality is not recommended.
2. The USB Serial JTAG function is not yet supported but will be available in a future version.
1. The current chip is version EC01. Some aspects of this version differ from the production version, so we cannot provide the ESP32-P4 ECO1 chip manual and PCB package at this time. Once the production version is available, we will update the [Resources] section. Thank you for your attention.
1. The current SDK does not yet fully support the 400MHz frequency for the ESP32-P4 HP core. It will be updated in the ESP-IDF once the SDK is fully developed.
1. 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, are progressing but not yet stable enough to release. Once these functionalities are refined, we will add examples to the wiki.
2. If you have ideas or partially validated application scenarios, feel free to share them with us for feasibility assessment.
1. For stability, PlatformIO support for the ESP32-P4 will require the PlatformIO community to support Arduino-esp32 SDK V3.1x.
2. 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.
Monday-Friday (9:30-6:30) Saturday (9:30-5:30)
Email: services01@spotpear.com