Build with idf version 6.4.0 seems to fail in platformio

[vortex314]

Processing esp32dev (board: esp32dev; platform: espressif32@^6.4.0; framework: espidf)

Verbose mode can be enabled via -v, --verbose option
CONFIGURATION: https://docs.platformio.org/page/boards/espressif32/esp32dev.html
PLATFORM: Espressif 32 (6.12.0) > Espressif ESP32 Dev Module
HARDWARE: ESP32 240MHz, 320KB RAM, 4MB Flash
DEBUG: Current (cmsis-dap) External (cmsis-dap, esp-bridge, esp-prog, iot-bus-jtag, jlink, minimodule, olimex-arm-usb-ocd, olimex-arm-usb-ocd-h, olimex-arm-usb-tiny-h, olimex-jtag-tiny, tumpa)
PACKAGES:

• framework-espidf @ 3.50102.0 (5.1.2)
• tool-cmake @ 3.30.2
• tool-esp-rom-elfs @ 0.0.1+20241011
• tool-esptoolpy @ 2.40900.250804 (4.9.0)
• tool-ninja @ 1.7.1
• tool-riscv32-esp-elf-gdb @ 12.1.0+20221002
• tool-xtensa-esp-elf-gdb @ 12.1.0+20221002
• toolchain-esp32ulp @ 1.23800.240113 (2.38.0)
• toolchain-xtensa-esp-elf @ 14.2.0+20241119
  Reading CMake configuration...
  Warning! Flash memory size mismatch detected. Expected 4MB, found 2MB!
  Please select a proper value in your sdkconfig.defaults or via the menuconfig target!
  LDF: Library Dependency Finder -> https://bit.ly/configure-pio-ldf
  LDF Modes: Finder ~ chain, Compatibility ~ soft
  Found 0 compatible libraries
  Scanning dependencies...
  No dependencies
  Building in release mode
  Compiling .pio/build/esp32dev/main/esp32_nat_router.c.o
  Compiling .pio/build/esp32dev/main/http_server.c.o
  Archiving .pio/build/esp32dev/esp-idf/acl/libacl.a
  Indexing .pio/build/esp32dev/esp-idf/acl/libacl.a
  main/esp32_nat_router.c:20:10: fatal error: driver/uart_vfs.h: No such file or directory
  20 | #include "driver/uart_vfs.h"
  | ^~~~~~~~~~~~~~~~~~~
  compilation terminated.
  Compiling .pio/build/esp32dev/app_trace/app_trace_util.c.o
  *** [.pio/build/esp32dev/main/esp32_nat_router.c.o] Error 1
  In file included from main/http_server.c:23:
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/lwip/lwip/src/include/lwip/lwip_napt.h:102:29: warning: 'struct netif' declared inside parameter list will not be visible outside of this definition or declaration
  102 | ip_napt_enable_netif(struct netif netif, int enable);
  | ^~~~~
  main/http_server.c: In function 'config_get_handler':
  main/http_server.c:1059:9: error: unknown type name 'ip4_addr_t'; did you mean 'in_addr_t'?
  1059 | ip4_addr_t sta_addr;
  | ^~~~~~~~~~
  | in_addr_t
  main/http_server.c:1060:17: error: request for member 'addr' in something not a structure or union
  1060 | sta_addr.addr = my_ip;
  | ^
  In file included from /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif.h:12,
  from /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_wifi/include/esp_wifi_default.h:10,
  from /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_wifi/include/esp_wifi.h:58,
  from main/http_server.c:10:
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:43:72: error: request for member 'addr' in something not a structure or union
  43 | #define esp_ip4_addr_get_byte(ipaddr, idx) (((const uint8_t)(&(ipaddr)->addr))[idx])
  | ^~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:44:31: note: in expansion of macro 'esp_ip4_addr_get_byte'
  44 | #define esp_ip4_addr1(ipaddr) esp_ip4_addr_get_byte(ipaddr, 0)
  | ^~~~~~~~~~~~~~~~~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:50:45: note: in expansion of macro 'esp_ip4_addr1'
  50 | #define esp_ip4_addr1_16(ipaddr) ((uint16_t)esp_ip4_addr1(ipaddr))
  | ^~~~~~~~~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:55:24: note: in expansion of macro 'esp_ip4_addr1_16'
  55 | #define IP2STR(ipaddr) esp_ip4_addr1_16(ipaddr),
  | ^~~~~~~~~~~~~~~~
  main/http_server.c:1061:57: note: in expansion of macro 'IP2STR'
  1061 | snprintf(sta_ip_str, sizeof(sta_ip_str), IPSTR, IP2STR(&sta_addr));
  | ^~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:43:72: error: request for member 'addr' in something not a structure or union
  43 | #define esp_ip4_addr_get_byte(ipaddr, idx) (((const uint8_t*)(&(ipaddr)->addr))[idx])
  | ^~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:45:31: note: in expansion of macro 'esp_ip4_addr_get_byte'
  45 | #define esp_ip4_addr2(ipaddr) esp_ip4_addr_get_byte(ipaddr, 1)
  | ^~~~~~~~~~~~~~~~~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:51:45: note: in expansion of macro 'esp_ip4_addr2'
  51 | #define esp_ip4_addr2_16(ipaddr) ((uint16_t)esp_ip4_addr2(ipaddr))
  | ^~~~~~~~~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:56:5: note: in expansion of macro 'esp_ip4_addr2_16'
  56 | esp_ip4_addr2_16(ipaddr),
  | ^~~~~~~~~~~~~~~~
  main/http_server.c:1061:57: note: in expansion of macro 'IP2STR'
  1061 | snprintf(sta_ip_str, sizeof(sta_ip_str), IPSTR, IP2STR(&sta_addr));
  | ^~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:43:72: error: request for member 'addr' in something not a structure or union
  43 | #define esp_ip4_addr_get_byte(ipaddr, idx) (((const uint8_t*)(&(ipaddr)->addr))[idx])
  | ^~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:46:31: note: in expansion of macro 'esp_ip4_addr_get_byte'
  46 | #define esp_ip4_addr3(ipaddr) esp_ip4_addr_get_byte(ipaddr, 2)
  | ^~~~~~~~~~~~~~~~~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:52:45: note: in expansion of macro 'esp_ip4_addr3'
  52 | #define esp_ip4_addr3_16(ipaddr) ((uint16_t)esp_ip4_addr3(ipaddr))
  | ^~~~~~~~~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:57:5: note: in expansion of macro 'esp_ip4_addr3_16'
  57 | esp_ip4_addr3_16(ipaddr),
  | ^~~~~~~~~~~~~~~~
  main/http_server.c:1061:57: note: in expansion of macro 'IP2STR'
  1061 | snprintf(sta_ip_str, sizeof(sta_ip_str), IPSTR, IP2STR(&sta_addr));
  | ^~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:43:72: error: request for member 'addr' in something not a structure or union
  43 | #define esp_ip4_addr_get_byte(ipaddr, idx) (((const uint8_t*)(&(ipaddr)->addr))[idx])
  | ^~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:47:31: note: in expansion of macro 'esp_ip4_addr_get_byte'
  47 | #define esp_ip4_addr4(ipaddr) esp_ip4_addr_get_byte(ipaddr, 3)
  | ^~~~~~~~~~~~~~~~~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:53:45: note: in expansion of macro 'esp_ip4_addr4'
  53 | #define esp_ip4_addr4_16(ipaddr) ((uint16_t)esp_ip4_addr4(ipaddr))
  | ^~~~~~~~~~~~~
  /home/lieven/.platformio/packages/framework-espidf@src-b6465284554c190b6435cd38366abea9/components/esp_netif/include/esp_netif_ip_addr.h:58:5: note: in expansion of macro 'esp_ip4_addr4_16'
  58 | esp_ip4_addr4_16(ipaddr)
  | ^~~~~~~~~~~~~~~~
  main/http_server.c:1061:57: note: in expansion of macro 'IP2STR'
  1061 | snprintf(sta_ip_str, sizeof(sta_ip_str), IPSTR, IP2STR(&sta_addr));
  | ^~~~~~
  main/http_server.c: In function 'mappings_get_handler':
  main/http_server.c:1164:39: error: 'IPADDR_NONE' undeclared (first use in this function)
  1164 | if (ip == IPADDR_NONE) {
  | ^~~~~~~~~~~
  main/http_server.c:1164:39: note: each undeclared identifier is reported only once for each function it appears in
  *** [.pio/build/esp32dev/main/http_server.c.o] Error 1
  ==================================================== [FAILED] Took 2.57 seconds ====================================================

[martin-ger]

Hmm, Gemini thinks it is a problem with the esp-idf 5.x that platformio uses. However I compile the project now with the lastest esp-idf 5.5.2 without issues. Maybe Gemini's ideas help:

Here are the two ways to fix this:
Option 1: The "Quick Fix" (Recommended)

The easiest way is to tell PlatformIO to use the older, compatible version of the ESP32 platform. This will make the code compile immediately without any manual changes.

Modify your platformio.ini to look like this:
Ini, TOML

[env:esp32dev]
platform = espressif32 @ 5.3.0 ; This forces ESP-IDF v4.4.x
framework = espidf
board = esp32dev
monitor_speed = 115200

; Fix for your 2MB Flash warning
board_build.flash_size = 2MB
board_upload.flash_size = 2MB

Note: After changing this, delete the .pio folder in your project and rebuild.

Option 2: Manually updating the code for v5.x

If you want to stick with the modern ESP-IDF v5.1.2, you must fix the code manually:

1. Fix the UART Header

In esp32_nat_router.c, find and replace the UART includes:

Remove: #include "driver/uart_vfs.h"

Add: 

#include "esp_vfs_dev.h
#include "driver/uart.h"

2. Fix the Networking Errors

In http_server.c, the compiler doesn't recognize ip4_addr_t because the old tcpip_adapter is gone. You need to add the new network interface headers at the top of the file:
C

#include "esp_netif.h"
#include "lwip/ip_addr.h"
#include "lwip/inet.h"

3. Handling ip4_addr_t

In v5.x, you cannot always access .addr directly as a member. If you see an error like request for member 'addr' in something not a structure, you might need to change the assignment:

Old: sta_addr.addr = my_ip;

New: memcpy(&sta_addr, &my_ip, sizeof(ip4_addr_t)); or simply sta_addr = *(ip4_addr_t*)&my_ip;

Summary of the "Flash Mismatch"

Your log showed: Expected 4MB, found 2MB!. Even if the code compiles, the ESP32 will crash during boot if the partition table is larger than the physical chip.

[vortex314]

Hi @martin-ger thanks for answering so fast, yeah I used also Gemini to get the same answers, but it just brings you deeper into the rabbit hole of incompatibilities and fixes. What is preferred build system to make the image ?

[martin-ger]

For me it works flawlessly with ESP-IDF 5.5.2.