Support ESP-IDF v5.5.1 on espressif32 platform

[MRamsay]

As the title says, could the supported ESP-IDF version get bumped from v5.5.0 to v5.5.1? It contains some bugfixes that I'd find useful.

---

In the meantime, I've tried bumping the version on a local ESP-IDF repo as per this forum thread but I end up with some issues.

I cloned the ESP-IDF repo successfully,

$ idf.py --version
ESP-IDF v5.5.1

I linked to the local ESP-IDF repo, in my platformio.ini

...
platform = espressif32
platform_packages =
    framework-espidf @ file:///Users/michaelramsay/esp/esp-idf
board = esp-wrover-kit
framework = espidf
...

But I get the same issue that was noted in #1633. Note that I'm running on an M1 Mac.

toolchain-xtensa-esp-elf/bin/xtensa-esp32-elf-g++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Building ESP-IDF components for target esp32
-- Configuring incomplete, errors occurred!

CMake Error at /Users/michaelramsay/.platformio/packages/framework-espidf/tools/cmake/build.cmake:629 (message):
  usage: __main__.py [-h] [--project_dir PROJECT_DIR]

                     [--interface_version {0,1,2,3}] [--lock_path LOCK_PATH]
                     {prepare_dependencies,inject_requirements,inject_requrements}
                     ...

  __main__.py: error: argument --interface_version: invalid choice: 4 (choose
  from 0, 1, 2, 3)

Call Stack (most recent call first):
  /Users/michaelramsay/.platformio/packages/framework-espidf/tools/cmake/project.cmake:740 (idf_build_process)
  CMakeLists.txt:3 (project)

However in my case, I tried removing ~/.platformio/penv, as well as completely removing all of ~/.platformio, and still no luck.

Here's my refreshed pip packages

$ which python
/Users/michaelramsay/.platformio/penv/bin/python
$ pip list
Package            Version
------------------ ----------
ajsonrpc           1.2.0
anyio              4.11.0
bottle             0.13.4
certifi            2025.11.12
chardet            5.2.0
charset-normalizer 3.4.4
click              8.1.7
colorama           0.4.6
h11                0.16.0
idna               3.11
marshmallow        3.26.1
packaging          25.0
pip                25.3
platformio         6.1.18
pyelftools         0.32
pyserial           3.5
requests           2.32.5
semantic-version   2.10.0
setuptools         65.5.0
sniffio            1.3.1
starlette          0.46.2
tabulate           0.9.0
typing_extensions  4.15.0
urllib3            2.5.0
uvicorn            0.34.3
wsproto            1.3.1

I tried the workaround making a pre: script with

import os
os.environ["IDF_COMPONENT_MANAGER"] = "0"

But I get a result which makes me think that I actually do need interface version 4, for kconfig.

-- Project sdkconfig file /Users/michaelramsay/smartcocoondevice/sdkconfig.development
-- Configuring incomplete, errors occurred!

Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfgen/__main__.py", line 16, in <module>
    main()
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfgen/core.py", line 319, in main
    config = kconfiglib.Kconfig(args.kconfig)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfiglib.py", line 947, in __init__
    self._init(filename, warn, warn_to_stderr, encoding)
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfiglib.py", line 1085, in _init
    self._parse_block(None, self.top_node, self.top_node).next = None
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfiglib.py", line 3021, in _parse_block
    self._parse_block(_T_ENDMENU, node, node)
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfiglib.py", line 2982, in _parse_block
    prev = self._parse_block(None, parent, prev)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfiglib.py", line 2982, in _parse_block
    prev = self._parse_block(None, parent, prev)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfiglib.py", line 3021, in _parse_block
    self._parse_block(_T_ENDMENU, node, node)
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfiglib.py", line 3020, in _parse_block
    self._parse_props(node)
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfiglib.py", line 3151, in _parse_props
    self._parse_help(node)
  File "/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/lib/python3.11/site-packages/kconfiglib.py", line 3306, in _parse_help
    if node.help is not None:
       ^^^^^^^^^
AttributeError: 'MenuNode' object has no attribute 'help'
CMake Error at /Users/michaelramsay/.platformio/packages/framework-espidf/tools/cmake/kconfig.cmake:237 (message):
  Failed to run kconfgen
  (/Users/michaelramsay/.platformio/penv/.espidf-5.5.1/bin/python;-m;kconfgen;--list-separator=semicolon;--kconfig;/Users/michaelramsay/.platformio/packages/framework-espidf/Kconfig;--sdkconfig-rename;/Users/michaelramsay/.platformio/packages/framework-espidf/sdkconfig.rename;--config;/Users/michaelramsay/smartcocoondevice/sdkconfig.development;--env;IDF_MINIMAL_BUILD=n;--env-file;/Users/michaelramsay/smartcocoondevice/.pio/build/development/config.env).
  Error 1
Call Stack (most recent call first):
  /Users/michaelramsay/.platformio/packages/framework-espidf/tools/cmake/build.cmake:704 (__kconfig_generate_config)
  /Users/michaelramsay/.platformio/packages/framework-espidf/tools/cmake/project.cmake:740 (idf_build_process)
  CMakeLists.txt:3 (project)

Anyways that's as far as I've gotten. I'd very much appreciate a version bump, and/or some help with upgrading my version locally.

[italocjs]

+1