How to include esp-idf v5 headers when framework=arduino?

Development Platforms
,
1

I know that pio-core3.0 has already upgrade to esp-idf v5.x, and I have found topic showing there are v5.x headers in “./framework-espidf/components” indeed.
while I’m using arduino framework, I can only include traditional headers that can be found in v4.4.7 document. I’d like to know the problem is the whether arduino framework’s unsupporting of v5.x api or my wrong ini configuration?

My env:

PLATFORM: Espressif 32 (6.7.0) > LilyGo T-Display-S3
HARDWARE: ESP32S3 240MHz, 320KB RAM, 16MB Flash
PACKAGES:
 - framework-arduinoespressif32 @ 3.20016.0 (2.0.16)
 - tool-esptoolpy @ 1.40501.0 (4.5.1)
 - tool-mkfatfs @ 2.0.1
 - tool-mklittlefs @ 1.203.210628 (2.3)
 - tool-mkspiffs @ 2.230.0 (2.30)
 - toolchain-riscv32-esp @ 8.4.0+2021r2-patch5
 - toolchain-xtensa-esp32s3 @ 8.4.0+2021r2-patch5

My ini:

[env:lilygo-t-display-s3_release]
platform = espressif32
board = lilygo-t-display-s3
framework = arduino
; change microcontroller
board_build.mcu = esp32s3
; change MCU frequency
board_build.f_cpu = 240000000L

build_flags =
	-D USER_SETUP_LOADED=1
	-include $PROJECT_LIBDEPS_DIR/$PIOENV/TFT_eSPI/User_Setups/Setup206_LilyGo_T_Display_S3.h

lib_deps =
	Wire
	bodmer/TFT_eSPI
	mathertel/OneButton
	contrem/arduino-timer
2

ESP-IDF 5.x will be used as base in Arduino 3.x.
Arduino 3.x is currently still a pre-release and is not yet supported by PlatformIO.

You can create an ESPIDF project with Arduino as ESPIDF component. You can find a detailed post about this here: Arduino as ESPIF Component in PlatformIO - solution that works

Otherwise you have to wait until Arduino 3.x is released and supported in PlatformIO.