platformio/platformio-core
1
0
Fork 1
mirror of https://github.com/platformio/platformio-core.git synced 2025-07-31 18:44:27 +02:00
Code Issues Packages Projects Releases Wiki Activity

Explain about SCons and how to fix installation

Browse Source
This commit is contained in:
Ivan Kravets
2015-12-11 00:16:06 +02:00
parent 2c301ca422
commit 9d01d86652
1 changed files with 27 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
docs/faq.rst
View File

@@ -103,22 +103,42 @@ Troubleshooting
Installation Installation
~~~~~~~~~~~~ ~~~~~~~~~~~~
PlatformIO and SCons aren't installed properly PlatformIO and ``SCons`` aren't installed properly
'''''''''''''''''''''''''''''''''''''''''''''' ''''''''''''''''''''''''''''''''''''''''''''''''''
Try these solutions: PlatformIO depends on awesome and irreplaceable software construction tool
named `SCons <http://www.scons.org>`_. PlatformIO Code Builder uses it to build
single source code for the multiple embedded platforms.
1. Upgrade SCons via `pip <https://pip.pypa.io>`_ When you install PlatformIO it tries to find ``scons`` program in your OS. If
SCons is installed in your system, then PlatformIO will use it. Otherwise,
PlatformIO tries to install it automatically using ``pip install scons``. So, if
you are here, then it means that PlatformIO could not install it for you.
Let fix it manually.
1. Need to cleanup all previous SCons installations using `pip <https://pip.pypa.io>`_
.. code-block:: bash .. code-block:: bash
[sudo] pip uninstall scons [sudo] pip uninstall scons
2. Try to install it manually
.. code-block:: bash
[sudo] pip install scons [sudo] pip install scons
# or if you have "error: option --single-version-externally-managed not recognized" # or if you have "error: option --single-version-externally-managed not recognized"
[sudo] pip install --egg scons [sudo] pip install --egg scons
2. Install PlatformIO using :ref:`installation_installer_script`. 3. If it didn't help you, try system OS package manager
* **Mac OS X** using `brew <http://brew.sh>`_ run ``brew install scons``
* **Linux** using ``apt`` run ``[sudo] apt-get install scons``
To identify that SCons is installed in your system run ``scons -v``.
.. _faq_troubleshooting_sconssingverextmanaged: .. _faq_troubleshooting_sconssingverextmanaged:
@@ -139,8 +159,8 @@ Answered in `issue #252 <https://github.com/platformio/platformio/issues/252#iss
.. _faq_troubleshooting_pionotfoundinpath: .. _faq_troubleshooting_pionotfoundinpath:
Program ``platformio`` not found in PATH Program "platformio" not found in PATH
'''''''''''''''''''''''''''''''''''''''' ''''''''''''''''''''''''''''''''''''''
Where is ``platformio`` binary installed? Run this command in Terminal Where is ``platformio`` binary installed? Run this command in Terminal