This sadly at the moment isn't too straightforward to do - you need to manually clone the git repo into your project's components folder (and potentially create it if it doesn't exist, it's not a default folder created by the PIO init command), and add its path to the root CMakeLists.txt

Here is an example repo and project. I recommend focusing on the aforementioned components folder and CMakeLists.txt (specifically the list(APPEND EXTRA_COMPONENT_DIRS part of the latter).

Alternatively, you can use M5Unified as a lib_dep.

I’ve narrowed down my compilation issue to the epdiy library when working with ESP-IDF on the M5PaperS3 (ESP32-S3). Here’s my setup and error details:

Configuration Without epdiy (Compiles Successfully):

[env:esp32-s3-devkitm-1]
platform = espressif32
board = esp32-s3-devkitm-1
framework = espidf
board_upload.flash_size = 16MB
board_upload.maximum_size = 16777216
board_build.arduino.memory_type = qio_opi
build_flags = -DBOARD_HAS_PSRAM

Add epdiy dep(Compilation fails):
lib_deps =
epdiy=https://github.com/vroland/epdiy.git

Error:
Multiple ways to build the same target were specified for: /epdiy/output_common/lut.o
(from ['/epdiy/src/output_common/lut.S'] and from ['/epdiy/src/output_common/lut.c'])

1. ESP32-S3 architecture(not generic ESP32),
2. ESP-IDF framework (no Arduino framework),
3. M5PaperS3 libraries from M5Paper S3 docs page

What I’ve already try:

• Followed M5Stack’s docs, but their examples for Arduino platform and lack S3-specific configurations.
• Try combining board = esp32-s3-devkitc-1 (as in M5 Core S3 docs) with espidf and M5GFX & epdiy libraries in platformio.ini file.

So:
If anyone has successfully linked ESP-IDF, ESP32-S3, and M5PaperS3 libraries in PlatformIO, could you share:

1. Your platformio.ini
2. Any critical patches or forks of M5GFX/epdiy required for ESP-IDF compatibility.
3. A minimal project (even just initializing the e-paper display) to start development under board.