feedc0de/platformio-core
1
0
Fork 0
forked from platformio/platformio-core
Code Pull Requests Activity

Improve installation section

Browse Source
This commit is contained in:
Ivan Kravets
2015-08-22 22:27:35 +03:00
parent 9f6c677276
commit 47d5783700
1 changed files with 26 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
docs/installation.rst
View File

@ -22,40 +22,21 @@ System requirements
All commands below should be executed in All commands below should be executed in
`Command-line <http://en.wikipedia.org/wiki/Command-line_interface>`_ `Command-line <http://en.wikipedia.org/wiki/Command-line_interface>`_
application: application (Terminal):
* *Mac OS X / Linux* this is *Terminal* application. * Mac OS X / Linux – *Terminal* application
* *Windows* this is * Windows – ``cmd.exe`` application.
`Command Prompt <http://en.wikipedia.org/wiki/Command_Prompt>`_ (``cmd.exe``)
application.
Troubleshooting Installation options
---------------
.. warning::
If you are going to run *PlatformIO* from **subprocess**, you
:ref:`MUST DISABLE <faq_troubleshooting_pioblocksprompt>` all prompts.
It will allow you to avoid blocking.
.. note::
**Linux Users:** Don't forget to install "udev" rules file
`99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
**Windows Users:** Please check that you have correctly installed USB driver
from board manufacturer
For further details, frequently questions, please refer to :ref:`faq`.
Installation Methods
-------------------- --------------------
.. note:: .. warning::
**Windows Users**: `Download the latest Python 2.7.x **Windows OS**: Please `Download the latest Python 2.7.x
<https://www.python.org/downloads/>`_ and install it. <https://www.python.org/downloads/>`_ and install it.
*DON'T FORGET* to select ``Add python.exe to Path`` feature in installation **DON'T FORGET** to select ``Add python.exe to Path`` feature on the
dialog on "Customize" stage. "Customize" stage.
Please *choose one of* the following installation methods: Please *choose one of* the following installation options:
Python Package Manager Python Package Manager
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~
@ -159,3 +140,20 @@ Install the latest PlatformIO from the ``develop`` branch:
If you want to be up-to-date with the latest ``develop`` version of PlatformIO, If you want to be up-to-date with the latest ``develop`` version of PlatformIO,
then you need to re-install PlatformIO each time if you see the new commits in then you need to re-install PlatformIO each time if you see the new commits in
`PlatformIO GitHub repository (branch: develop) <https://github.com/platformio/platformio/commits/develop>`_. `PlatformIO GitHub repository (branch: develop) <https://github.com/platformio/platformio/commits/develop>`_.
Troubleshooting
---------------
.. warning::
If you are going to run *PlatformIO* from **subprocess**, you
:ref:`MUST DISABLE <faq_troubleshooting_pioblocksprompt>` all prompts.
It will allow you to avoid blocking.
.. note::
**Linux OS**: Don't forget to install "udev" rules file
`99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
**Windows OS**: Please check that you have correctly installed USB driver
from board manufacturer
For further details, frequently questions, please refer to :ref:`faq`.