build error - display_audio_photo - around spiff - vs code - idf 5.5 (BSP-715)

[PreetM07]

Board

ESP32-S3, CoreS3

Hardware Description

I am using CoreS3

IDE Name

VSCode

Operating System

Windows 11

Description

I am trying to build the example on windown 11 with vs code, esp-idf extension
I have clonned the main repo - esp-bsp
then I opened the example display_audio_photo directly in the code
I was able to set the target to esp32-s3 inbuild usb-JTAG
but while i run build from the UI

i get
[4/1421] C:\WINDOWS\system32\cmd.exe /C "cd /D D:\Repo_NBD...D_Fiverr/TamAI/esp-idf-v5.5/tools/cmake/scripts/fail.cmake"
FAILED: CMakeFiles/spiffs_storage_bin D:/Repo_NBD/NBD_Fiverr/TamAI/esp-bsp/examples/display_audio_photo/build/CMakeFiles/spiffs_storage_bin
C:\WINDOWS\system32\cmd.exe /C "cd /D D:\Repo_NBD\NBD_Fiverr\TamAI\esp-bsp\examples\display_audio_photo\build && C:\Users\Public.espressif\tools\cmake\3.30.2\bin\cmake.exe -E echo "Failed to create SPIFFS image for partition 'storage'. " "Check project configuration if using the correct partition table file." && C:\Users\Public.espressif\tools\cmake\3.30.2\bin\cmake.exe -E remove D:/Repo_NBD/NBD_Fiverr/TamAI/esp-bsp/examples/display_audio_photo/build/cOBdM.cmake && C:\Users\Public.espressif\tools\cmake\3.30.2\bin\cmake.exe -E env "FAIL_MESSAGE=Failing the build (see errors on lines above)" C:/Users/Public/.espressif/tools/cmake/3.30.2/bin/cmake.exe -P D:/Repo_NBD/NBD_Fiverr/TamAI/esp-idf-v5.5/tools/cmake/scripts/fail.cmake"
Failed to create SPIFFS image for partition 'storage'. Check project configuration if using the correct partition table file.

I don't know how to solve this

Sketch

https://docs.m5stack.com/en/core/CoreS3

Other Steps to Reproduce

• clone the esp-bsp repo
• open the example in vs code directly from the powershell from the path of the example directory i.e. D:\Repo_NBD\NBD_Fiverr\TamAI\esp-bsp\examples\display_audio_photo
• use code . to open in the vs code
• connect the CoreS3 device
• select the flash method to JTAG
• select the COM
• set the device IDF-TARGET to esp32-s3
• build using esp-idf extension
• full clean and build again

I have checked existing issues, README.md and ESP32 Forum

• I confirm I have checked existing issues, online documentation and Troubleshooting guide.

[github-actions]

Hi @PreetM07! Please be aware that (1) the following suggestions are generated by a bot and haven't been fact-checked by Espressif Systems, (2) burning eFuses and enabling security features are irreversible operations and can damage your ESP32 device. We hope that this message will help you until an Espressif Engineer looks at your issue.

---

Thanks for the detailed report. The build error means the SPIFFS image for the “storage” partition wasn’t generated. This typically happens when the project’s partition table doesn’t define a SPIFFS “storage” partition matching what the build expects, or when the SPIFFS image creation step isn’t configured.

Please try:

1. Verify the partition table includes a SPIFFS partition named storage

• Open ESP-IDF: SDK Configuration Editor (menuconfig) → Partition Table, and ensure you’re using the project’s intended partition CSV (Custom Partition Table CSV if applicable). [Partition table]
• If needed, create or edit a custom partition table and add a SPIFFS entry named storage, for example:
  Name: storage, Type: data, SubType: spiffs, Size: e.g. 0xF0000 (or a size you prefer).
  You can do this quickly in VS Code with ESP-IDF: Open Partition Table Editor UI. [Assign. 4.2]

2. Ensure SPIFFS image is generated during build

• The build system normally calls spiffs_create_partition_image(storage FLASH_IN_PROJECT) from a component CMakeLists.txt so the image is produced and flashed on idf.py flash. If this call is missing or misconfigured, the build will fail with the exact message you see. [SPIFFS tools; spiffsgen example]
• Compare with the SPIFFS image-on-build example to confirm the pattern and where the call is placed. [spiffsgen example]

3. If you prefer manual image generation (to verify the pipeline)

• Use spiffsgen.py to create an image matching the storage partition size, then flash it:
  python spiffsgen.py <image_size> <base_dir> storage.bin
  Then flash storage.bin to the storage partition using idf.py flash or parttool/esptool. [SPIFFS tools]
• If you use symlinks in the host folder, check CONFIG_SPIFFS_FOLLOW_SYMLINKS in menuconfig so image creation includes them. [Kconfig SPIFFS symlinks]

4. Cross-check with a known-good example

• Build the official SPIFFS example or the spiffsgen example to verify your environment; they demonstrate the partition entry and spiffs_create_partition_image usage. [SPIFFS example; spiffsgen example]

5. VS Code extension notes

• If errors persist in VS Code, check the extension Troubleshooting docs to confirm the correct partition CSV is being used and paths are resolved as expected. [VS Code FAQs]

If your example expects a prebuilt SPIFFS image (like some ADF examples), ensure the image is flashed to the storage partition; otherwise you’ll see “spiffs partition could not be found.” [ADF SPIFFS note; ADF SPIFFS note (CN)]

If you can share:

• Your active partition CSV
• Any spiffs_create_partition_image(...) lines from CMakeLists.txt
  we can point to the exact mismatch.

[espzav]

Hello @PreetM07,
for BSP examples, you should use right sdkconfig.defaults for selected BSP like this: https://github.com/espressif/esp-bsp?tab=readme-ov-file#compiling-project-for-multiple-bsps