Troubleshooting

Note

Linux OS: Don’t forget to install 99-platformio-udev.rules

Windows OS: Please check that you have correctly installed the USB driver from the board manufacturer.

If you find any issues with PlatformIO Core Installer Script, please report to https://github.com/platformio/platformio-core-installer/issues

Multiple PlatformIO Cores in a system

Multiple standalone PlatformIO Core (CLI) in a system could lead to the different issues. We highly recommend to keep one instance of PlatformIO Core or use built-in PlatformIO Core in PlatformIO IDE:

PlatformIO IDE for VSCode - Settings > Set platformio-ide.useBuiltinPIOCore to true.

Finally, if you have a standalone PlatformIO Core (CLI) in a system, please open system Terminal (not PlatformIO IDE Terminal) and uninstall obsolete PlatformIO Core:

pip uninstall platformio
python -m pip uninstall platformio

# if you used macOS "brew"
brew uninstall platformio

If you need to have PlatformIO Core (CLI) globally in a system, please Install Shell Commands.

‘platformio’ is not recognized as an internal or external command

If you use PlatformIO IDE, please check in PlatformIO IDE Settings that “Use built-in PlatformIO Core” is enabled.

If you modify the system environment variable PATH in your Bash/Fish/ZSH profile, please do not override global PATH. This line export PATH="/my/custom/path" is incorrect. Use export PATH="/my/custom/path":$PATH instead.

ImportError: cannot import name _remove_dead_weakref

Windows users can experience this issue when multiple Python interpreters are installed in a system and conflict with each other. The easy way to fix this problem is uninstalling all Python interpreters using Windows Programs Manager and installing them manually again.

“Windows > Start Menu > Settings > System > Apps & Features”, select Python interpreters and uninstall them.
Install the latest Python interpreter, see Install Python Interpreter guide
Remove C:\Users\YourUserName\.platformio and C:\.platformio folders if exist (do not forget to replace “YourUserName” with the real user name)
Restart PlatformIO IDE.