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 Atom -
Menu PlatformIO: Settings > PlatformIO IDE > Use built-in PlatformIO Core
PlatformIO IDE for VSCode - Settings > Set
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 # 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
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
C:\.platformiofolders if exist (do not forget to replace “YourUserName” with the real user name)
Restart PlatformIO IDE.