Constant Need to Delete .pio Folder to Compile

[sylque]

In WSL:

Processing debugNoBle (platform: https://github.com/pioarduino/platform-espressif32/releases/download/55.03.34/platform-espressif32.zip; board: esp32-s3-devkitc-1; framework: arduino)
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Library Manager: Installing FS @ *
Library Manager: Installing SD_MMC @ *
Verbose mode can be enabled via `-v, --verbose` option
CONFIGURATION: https://docs.platformio.org/page/boards/espressif32/esp32-s3-devkitc-1.html
PLATFORM: Espressif 32 (55.3.34) > Espressif ESP32-S3-DevKitC-1-N8 (8 MB QD, No PSRAM)
HARDWARE: ESP32S3 240MHz, 320KB RAM, 8MB Flash
DEBUG: Current (esp-builtin) On-board (esp-builtin) 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: 
 - contrib-piohome @ 3.4.4 
 - framework-arduinoespressif32 @ 3.3.4 
 - framework-arduinoespressif32-libs @ 5.5.0+sha.8410210c9a 
 - tool-esp-rom-elfs @ 2024.10.11 
 - tool-esptoolpy @ 5.1.0 
 - tool-mklittlefs @ 3.2.0 
 - tool-openocd-esp32 @ 2.1200.20250707 (12.0) 
 - tool-xtensa-esp-elf-gdb @ 16.3.0+20250913 
 - toolchain-xtensa-esp-elf @ 14.2.0+20250730
LDF: Library Dependency Finder -> https://bit.ly/configure-pio-ldf
LDF Modes: Finder ~ off, Compatibility ~ soft
Found 64 compatible libraries
Scanning dependencies...
Dependency Graph
|-- ArduinoEigen @ 0.3.2
|-- OneButton @ 2.6.1
|-- PendulumComponents
|-- NetVarFsm
|-- ImuTools
|-- Wire @ 3.3.4
|-- SPI @ 3.3.4
|-- Preferences @ 3.3.4
Building in debug mode
Retrieving maximum program size .pio/build/debugNoBle/firmware.elf
Checking size .pio/build/debugNoBle/firmware.elf
Advanced Memory Usage is available via "PlatformIO Home > Project Inspect"
RAM:   [=         ]  12.0% (used 39272 bytes from 327680 bytes)
Flash: [====      ]  43.2% (used 1359071 bytes from 3145728 bytes)
=========================================================================== [SUCCESS] Took 29.00 seconds ===========================================================================

Environment    Status    Duration
-------------  --------  ------------
debugNoBle     SUCCESS   00:00:29.004
=========================================================================== 1 succeeded in 00:00:29.004 ===========================================================================
 *  Terminal will be reused by tasks, press any key to close it. 

In Windows:

Processing debugNoBle (platform: https://github.com/pioarduino/platform-espressif32/releases/download/55.03.34/platform-espressif32.zip; board: esp32-s3-devkitc-1; framework: arduino)
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Library Manager: Installing FS @ *
Library Manager: Installing SD_MMC @ *
Verbose mode can be enabled via `-v, --verbose` option
CONFIGURATION: https://docs.platformio.org/page/boards/espressif32/esp32-s3-devkitc-1.html
PLATFORM: Espressif 32 (55.3.34) > Espressif ESP32-S3-DevKitC-1-N8 (8 MB QD, No PSRAM)
HARDWARE: ESP32S3 240MHz, 320KB RAM, 8MB Flash
DEBUG: Current (esp-builtin) On-board (esp-builtin) 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: 
 - contrib-piohome @ 3.4.4 
 - framework-arduinoespressif32 @ 3.3.4 
 - framework-arduinoespressif32-libs @ 5.5.0+sha.8410210c9a 
 - tool-esp-rom-elfs @ 2024.10.11
 - tool-esptoolpy @ 5.1.0
 - tool-mklittlefs @ 3.2.0
 - tool-openocd-esp32 @ 2.1200.20250707 (12.0)
 - tool-xtensa-esp-elf-gdb @ 16.3.0+20250913
 - toolchain-xtensa-esp-elf @ 14.2.0+20250730
*** Applied include path shortening for 330 framework paths ***
*** Path length reduced from 40057 to ~14082 characters ***
*** Estimated savings: 25410 characters ***
LDF: Library Dependency Finder -> https://bit.ly/configure-pio-ldf
LDF Modes: Finder ~ off, Compatibility ~ soft
Found 68 compatible libraries
Scanning dependencies...
Dependency Graph
|-- ArduinoEigen @ 0.3.2
|-- OneButton @ 2.6.1
|-- Wire @ 3.3.4
|-- SPI @ 3.3.4
|-- Preferences @ 3.3.4
Building in debug mode
Compiling .pio\build\debugNoBle\src\main.cpp.o
Compiling .pio\build\debugNoBle\src\net-vars\substores\ActivitySubstore.cpp.o
Compiling .pio\build\debugNoBle\src\net-vars\substores\LaserSubstore.cpp.o
src/main.cpp:6:10: fatal error: syl/FreeRtosStats.h: No such file or directory
    6 | #include <syl/FreeRtosStats.h>
      |          ^~~~~~~~~~~~~~~~~~~~~
compilation terminated.
In file included from src/net-vars/substores/ActivitySubstore.cpp:7:
src/net-vars/substores/ActivitySubstore.h:9:10: fatal error: syl/NetVarFsm.h: No such file or directory
    9 | #include <syl/NetVarFsm.h>
      |          ^~~~~~~~~~~~~~~~~
compilation terminated.
In file included from src/net-vars/substores/LaserSubstore.cpp:7:
src/net-vars/substores/LaserSubstore.h:9:10: fatal error: syl/NetVarStore.h: No such file or directory
    9 | #include <syl/NetVarStore.h>
      |          ^~~~~~~~~~~~~~~~~~~
compilation terminated.
*** [.pio\build\debugNoBle\src\main.cpp.o] Error 1
Compiling .pio\build\debugNoBle\src\net-vars\substores\MarkerPosSubstore.cpp.o
*** [.pio\build\debugNoBle\src\net-vars\substores\ActivitySubstore.cpp.o] Error 1
*** [.pio\build\debugNoBle\src\net-vars\substores\LaserSubstore.cpp.o] Error 1
In file included from src/net-vars/substores/MarkerPosSubstore.cpp:7:
src/net-vars/substores/MarkerPosSubstore.h:9:10: fatal error: syl/NetVarStore.h: No such file or directory
    9 | #include <syl/NetVarStore.h>
      |          ^~~~~~~~~~~~~~~~~~~
compilation terminated.
*** [.pio\build\debugNoBle\src\net-vars\substores\MarkerPosSubstore.cpp.o] Error 1
=========================================================================== [FAILED] Took 12.98 seconds ===========================================================================

Environment    Status    Duration
-------------  --------  ------------
debugNoBle     FAILED    00:00:12.979
====================================================================== 1 failed, 0 succeeded in 00:00:12.979 ====================================================================== 

 *  The terminal process "C:\Users\Sylvain\.platformio\penv\Scripts\platformio.exe 'run', '--environment', 'debugNoBle'" terminated with exit code: 1. 
 *  Terminal will be reused by tasks, press any key to close it. 

As you can see some dependencies are not found under Windows, namely: PendulumComponents, NetVarFsm, ImuTools.

Extract of my platform.ini file:

[platformio]
default_envs = debugNoBle
build_cache_dir = ${platformio.core_dir}/build_cache

[env]
platform = https://github.com/pioarduino/platform-espressif32/releases/download/55.03.34/platform-espressif32.zip
board = esp32-s3-devkitc-1
framework = arduino
monitor_speed = 115200
upload_speed = 1500000
board_build.partitions = huge_app.csv
build_unflags = 
  -Os
  -Werror=all
  -std=gnu++2a -std=gnu++2b
  -fno-rtti
build_flags = 
  -std=gnu++23
  -I".pio/libdeps/${PIOENV}/Adafruit BusIO" ; Required for lib_ldf_mode = off
  -I"${platformio.packages_dir}/framework-arduinoespressif32/libraries/Wire/src" ; Required for lib_ldf_mode = off
  -I"${platformio.packages_dir}/framework-arduinoespressif32/libraries/SPI/src" ; Required for lib_ldf_mode = off
  -I"${platformio.packages_dir}/framework-arduinoespressif32/libraries/Preferences/src" ; Required for lib_ldf_mode = off
lib_deps =
  ArduinoEigen
  mathertel/OneButton
  symlink://../../PendulumComponents
  symlink://../../../AymLibs/NetVarFsm
  symlink://../../../AymLibs/ImuTools
  Wire ; Required for lib_ldf_mode = off
  SPI ; Required for lib_ldf_mode = off
  Preferences ; Required for lib_ldf_mode = off
lib_ldf_mode = off

[sylque]

What's even more puzzling is that, under Windows, within the same platformio.ini, one environment compiles fine whereas the other two don't.

Here is my complete platform.ini:

; PlatformIO Project Configuration File
;
;   Build options: build flags, source filter
;   Upload options: custom upload port, speed and extra flags
;   Library options: dependencies, extra library storages
;   Advanced options: extra scripting
;
; Please visit documentation for the other options and examples
; https://docs.platformio.org/page/projectconf.html

[platformio]
default_envs = debugNoBle
build_cache_dir = ${platformio.core_dir}/build_cache

##################################################

[env]
platform = https://github.com/pioarduino/platform-espressif32/releases/download/55.03.34/platform-espressif32.zip
board = esp32-s3-devkitc-1
framework = arduino
monitor_speed = 115200
upload_speed = 1500000
board_build.partitions = huge_app.csv
build_unflags = 
  -Os
  -Werror=all
  -std=gnu++2a -std=gnu++2b
  -fno-rtti
build_flags = 
  -std=gnu++23
  -I".pio/libdeps/${PIOENV}/Adafruit BusIO" ; Required for lib_ldf_mode = off
  -I"${platformio.packages_dir}/framework-arduinoespressif32/libraries/Wire/src" ; Required for lib_ldf_mode = off
  -I"${platformio.packages_dir}/framework-arduinoespressif32/libraries/SPI/src" ; Required for lib_ldf_mode = off
  -I"${platformio.packages_dir}/framework-arduinoespressif32/libraries/Preferences/src" ; Required for lib_ldf_mode = off
lib_deps =
  ArduinoEigen
  mathertel/OneButton
  symlink://../../PendulumComponents
  symlink://../../../AymLibs/NetVarFsm
  symlink://../../../AymLibs/ImuTools
  Wire ; Required for lib_ldf_mode = off
  SPI ; Required for lib_ldf_mode = off
  Preferences ; Required for lib_ldf_mode = off
lib_ldf_mode = off

##################################################

[ble]
lib_deps = 
  symlink://../../../AymLibs/BleTasksForSlAndSp
build_src_filter =
build_flags = 
  -D ENABLE_BLE=true

[noBle]
lib_deps = 
build_src_filter = +<*> -<.git/> -<.svn/> -<tasks/BleTasks.cpp> 
build_flags = 
  -D ENABLE_BLE=false 

##################################################

[debug]
build_type = debug
build_flags = 
  -Og

[release]
build_type = release
build_flags = 
  -DNDEBUG 
  -O3

##################################################

[env:debug]
extends = debug
lib_deps = ${env.lib_deps} ${ble.lib_deps}
build_flags = ${env.build_flags} ${ble.build_flags} ${debug.build_flags}
build_src_filter = ${ble.build_src_filter}

[env:debugNoBle]
extends = debug
lib_deps = ${env.lib_deps} ${noBle.lib_deps}
build_flags = ${env.build_flags} ${noBle.build_flags} ${debug.build_flags}
build_src_filter = ${noBle.build_src_filter}

[env:release]
extends = release
lib_deps = ${env.lib_deps} ${ble.lib_deps}
build_flags = ${env.build_flags} ${ble.build_flags} ${release.build_flags}
build_src_filter = ${ble.build_src_filter}

##################################################

When I compile the debug environment, everything works as expected, just like in WSL. However, environments debugNoBle and release both trigger the error described in my first post.

[sylque]

It turns out that simply deleting the .pio folder was all it took to get things working again—though I could have sworn I’d already tried that.

I’m leaving this issue open on purpose, because having to delete the .pio folder multiple times a day is becoming very frustrating.