Fix matching of "components" dir when there's a symlink in the path to .platformio

[mhkrebs]

compile_source_files() uses a relative path for the object if the source file is within the "components" tree. It checks the path string with .startswith(), though, and that can fail if the paths point to the same file but look different due to symlinks.

In my case, it saw two different source paths in "target-__idf_efuse-5f3f9f6e3513e0903efa.json":

1. /space/home/user/.platformio/packages/framework-espidf/components/efuse/esp32c6/esp_efuse_fields.c
2. /space/home/user/.platformio/packages/framework-espidf/components/efuse/src/esp_efuse_fields.c

But my home directory uses a symlink, so components_dir was:

• /home/user/.platformio/packages/framework-espidf/components

This resulted in attempting to build the same object file for both:

*** Multiple ways to build the same target were specified for: /space/home/user/git/project/esphome/.esphome/build/device/.pioenvs/device/esp_efuse_fields.c.o  (from ['/space/home/user/.platformio/packages/framework-espidf/components/efuse/esp32c6/esp_efuse_fields.c'] and from ['/space/home/user/.platformio/packages/framework-espidf/components/efuse/src/esp_efuse_fields.c'])
File "/home/user/.platformio/platforms/espressif32/builder/frameworks/espidf.py", line 773, in compile_source_files

This fix simply resolves any symlinks in components_dir before using it for the comparison.

Fixes #515

[valeros]

Hi @mhkrebs, thanks for the PR. Could you please provide instructions how to reproduce the issue?

[mhkrebs]

In my case (and in this comment), the issue is that /home is a symlink. (I'm on Linux). I've seen others have the problem when ~/.platformio is a symlink.

To reproduce maybe try:

cd
mv .platformio temp
ln -s temp .platformio
cd esphome
esphome compile device.yaml

(BTW, I don't feel sentimental about this PR... I can believe there's a better fix for this.)

[Jason2866]

Well the fix isn't a fix, it breaks Windows compile.

[mhkrebs]

Alright, I updated the fix. Sorry about that. I was worried about that possibility, that the source paths might not be resolved themselves. (I'm guessing that's the issue on Windows.)

I don't have Windows, but with this updated fix it still fixes my issue on Linux. I don't know how to test for Windows, but it looks like the tests will automatically run for this PR? Although, like I implied, I'm fine if somebody wants to make a better fix for this... I just want to be able to compile ESPHome. :)

[VulpesFurvus]

Hi, I'm running the device update in home assistant and having the same error with the latest update of ESPHome v2025.6.2:

INFO ESPHome 2025.6.2
INFO Reading configuration /config/esphome/m5stack-atom-lite-******.yaml...
INFO Generating C++ source...
INFO Updating https://github.com/espressif/[email protected]
INFO Compiling app...
Processing m5stack-atom-lite-****** (board: m5stack-atom; framework: espidf; platform: https://github.com/pioarduino/platform-espressif32/releases/download/53.03.13/platform-espressif32.zip)
--------------------------------------------------------------------------------
HARDWARE: ESP32 240MHz, 320KB RAM, 4MB Flash
 - framework-espidf @ 3.50302.0 (5.3.2) 
 - tool-cmake @ 3.30.2 
 - tool-esptoolpy @ 4.8.6 
 - tool-mklittlefs @ 3.2.0 
 - tool-ninja @ 1.10.2 
 - tool-riscv32-esp-elf-gdb @ 14.2.0+20240403 
 - tool-xtensa-esp-elf-gdb @ 14.2.0+20240403 
 - toolchain-esp32ulp @ 2.35.0-20220830 
 - toolchain-xtensa-esp-elf @ 13.2.0+20240530
Reading CMake configuration...
Warning! The `/data/cache/platformio/packages/framework-espidf/components/esp_driver_gpio/linker.lf` fragment is not found!
Warning! The `/data/cache/platformio/packages/framework-espidf/components/esp_mm/linker.lf` fragment is not found!
(...)
Warning! The `/data/cache/platformio/packages/framework-espidf/components/ieee802154/linker.lf` fragment is not found!
Warning! The `/data/cache/platformio/packages/framework-espidf/components/openthread/linker.lf` fragment is not found!

*** Multiple ways to build the same target were specified for: /data/build/m5stack-atom-lite-******/.pioenvs/m5stack-atom-lite-b85da4/esp_efuse_fields.c.o  (from ['/data/cache/platformio/packages/framework-espidf/components/efuse/esp32/esp_efuse_fields.c'] and from ['/data/cache/platformio/packages/framework-espidf/components/efuse/src/esp_efuse_fields.c'])
File "/data/cache/platformio/platforms/espressif32/builder/frameworks/espidf.py", line 1044, in compile_source_files
========================== [FAILED] Took 6.73 seconds ==========================