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 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 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
# if you used macOS "brew"
brew uninstall platformio
If you need to have PlatformIO Core (CLI) globally in a system, please Install Shell Commands.
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.
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.