PlatformIO Python 3.13 post-build failure #7

Open
opened 2026-03-26 22:24:57 +00:00 by antialias · 0 comments
Owner

The firmware.bin generation step fails intermittently on macOS with Python 3.13 due to a TypeError in PlatformIO's pioarduino-build.py:

TypeError: argument should be a str or an os.PathLike object where __fspath__ returns a str, not 'NoneType'

The actual compilation and linking succeed — only the post-build esptool image creation step fails. Subsequent cached builds succeed.

Environment:

  • macOS (Darwin 25.3.0)
  • Python 3.13.11
  • PlatformIO Espressif32 platform 55.3.37
  • framework-arduinoespressif32 3.3.7

Workaround: Run pio run again (cached build succeeds).

Likely fix: Pin platform version or wait for upstream fix in pioarduino.

The firmware.bin generation step fails intermittently on macOS with Python 3.13 due to a `TypeError` in PlatformIO's `pioarduino-build.py`: ``` TypeError: argument should be a str or an os.PathLike object where __fspath__ returns a str, not 'NoneType' ``` The actual compilation and linking succeed — only the post-build `esptool` image creation step fails. Subsequent cached builds succeed. **Environment:** - macOS (Darwin 25.3.0) - Python 3.13.11 - PlatformIO Espressif32 platform 55.3.37 - framework-arduinoespressif32 3.3.7 **Workaround:** Run `pio run` again (cached build succeeds). **Likely fix:** Pin platform version or wait for upstream fix in pioarduino.
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: antialias/eink-photo-frame#7