Bump to 0.10.0 (resolve issues: #11, #21, #35, #37, #38, #39, #40, #43 )

Fixed example for Eclipse IDE with Tiva board

.gitignore

@@ -5,3 +5,5 @@
 .sconsign.dblite
 examples/ide-eclipse/.metadata
 examples/ide-eclipse/RemoteSystemsTempFiles
+docs/_build
+dist

.pylintrc

@@ -38,7 +38,7 @@ load-plugins=
 # --enable=similarities". If you want to run only the classes checker, but have
 # no Warning level messages displayed, use"--disable=all --enable=classes
 # --disable=W"
-disable=C0103,C0111,E0611,F0401,I0011,R0801,R0903
+disable=C0103,C0111,E0611,F0401,I0011,R0801,R0903,R0922
 
 
 [REPORTS]

HISTORY.rst

@@ -1,8 +1,109 @@
 Release History
 ===============
 
-1.0.0 (?)
----------
+0.10.0 (2015-01-01) Happy New Year!
+-----------------------------------
+
+* Implemented `platformio boards <http://docs.platformio.org/en/latest/userguide/cmd_boards.html>`_
+  command (`issue #11 <https://github.com/ivankravets/platformio/issues/11>`_)
+* Added support of *Engduino* boards for
+  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#engduino>`__
+  platform (`issue #38 <https://github.com/ivankravets/platformio/issues/38>`_)
+* Added ``--board`` option to `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`_
+  command which allows to initialise project with the specified embedded boards
+  (`issue #21 <https://github.com/ivankravets/platformio/issues/21>`_)
+* Added `example with uploading firmware <http://docs.platformio.org/en/latest/projectconf.html#examples>`_
+  via USB programmer (USBasp) for
+  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html>`_
+  *MCUs* (`issue #35 <https://github.com/ivankravets/platformio/issues/35>`_)
+* Automatic detection of port on `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_
+  (`issue #37 <https://github.com/ivankravets/platformio/issues/37>`_)
+* Allowed auto-installation of platforms when prompts are disabled (`issue #43 <https://github.com/ivankravets/platformio/issues/43>`_)
+* Fixed urllib3's *SSL* warning under Python <= 2.7.2 (`issue #39 <https://github.com/ivankravets/platformio/issues/39>`_)
+* Fixed bug with *Arduino USB* boards (`issue #40 <https://github.com/ivankravets/platformio/issues/40>`_)
+
+
+0.9.2 (2014-12-10)
+------------------
+
+* Replaced "dark blue" by "cyan" colour for the texts (`issue #33 <https://github.com/ivankravets/platformio/issues/33>`_)
+* Added new setting `enable_prompts <http://docs.platformio.org/en/latest/userguide/cmd_settings.html>`_
+  and allowed to disable all *PlatformIO* prompts (useful for cloud compilers)
+  (`issue #34 <https://github.com/ivankravets/platformio/issues/34>`_)
+* Fixed compilation bug on *Windows* with installed *MSVC* (`issue #18 <https://github.com/ivankravets/platformio/issues/18>`_)
+
+0.9.1 (2014-12-05)
+------------------
+
+* Ask user to install platform (when it hasn't been installed yet) within
+  `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
+  and `platformio show <http://docs.platformio.org/en/latest/userguide/cmd_show.html>`_ commands
+* Improved main `documentation <http://docs.platformio.org>`_
+* Fixed "*OSError: [Errno 2] No such file or directory*" within
+  `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
+  command when PlatformIO isn't installed properly
+* Fixed example for `Eclipse IDE with Tiva board <https://github.com/ivankravets/platformio/tree/develop/examples/ide-eclipse>`_
+  (`issue #32 <https://github.com/ivankravets/platformio/issues/32>`_)
+* Upgraded `Eclipse Project Examples <https://github.com/ivankravets/platformio/tree/develop/examples/ide-eclipse>`_
+  to latest *Luna* and *PlatformIO* releases
+
+0.9.0 (2014-12-01)
+------------------
+
+* Implemented `platformio settings <http://docs.platformio.org/en/latest/userguide/cmd_settings.html>`_ command
+* Improved `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`_ command.
+  Added new option ``--project-dir`` where you can specify another path to
+  directory where new project will be initialized (`issue #31 <https://github.com/ivankravets/platformio/issues/31>`_)
+* Added *Migration Manager* which simplifies process with upgrading to a
+  major release
+* Added *Telemetry Service* which should help us make *PlatformIO* better
+* Implemented *PlatformIO AppState Manager* which allow to have multiple
+  ``.platformio`` states.
+* Refactored *Package Manager*
+* Download Manager: fixed SHA1 verification within *Cygwin Environment*
+  (`issue #26 <https://github.com/ivankravets/platformio/issues/26>`_)
+* Fixed bug with code builder and built-in Arduino libraries
+  (`issue #28 <https://github.com/ivankravets/platformio/issues/28>`_)
+
+0.8.0 (2014-10-19)
+------------------
+
+* Avoided trademark issues in `library.json <http://docs.platformio.org/en/latest/librarymanager/config.html>`_
+  with the new fields: `frameworks <http://docs.platformio.org/en/latest/librarymanager/config.html#frameworks>`_,
+  `platforms <http://docs.platformio.org/en/latest/librarymanager/config.html#platforms>`_
+  and `dependencies <http://docs.platformio.org/en/latest/librarymanager/config.html#dependencies>`_
+  (`issue #17 <https://github.com/ivankravets/platformio/issues/17>`_)
+* Switched logic from "Library Name" to "Library Registry ID" for all
+  `platformio lib <http://docs.platformio.org/en/latest/userguide/lib/index.html>`_
+  commands (install, uninstall, update and etc.)
+* Renamed ``author`` field to `authors <http://docs.platformio.org/en/latest/librarymanager/config.html#authors>`_
+  and allowed to setup multiple authors per library in `library.json <http://docs.platformio.org/en/latest/librarymanager/config.html>`_
+* Added option to specify "maintainer" status in `authors <http://docs.platformio.org/en/latest/librarymanager/config.html#authors>`_ field
+* New filters/options for `platformio lib search <http://docs.platformio.org/en/latest/userguide/lib/cmd_search.html>`_
+  command: ``--framework`` and ``--platform``
+
+0.7.1 (2014-10-06)
+------------------
+
+* Fixed bug with order for includes in conversation from INO/PDE to CPP
+* Automatic detection of port on upload (`issue #15 <https://github.com/ivankravets/platformio/issues/15>`_)
+* Fixed lib update crashing when no libs are installed (`issue #19 <https://github.com/ivankravets/platformio/issues/19>`_)
+
+
+0.7.0 (2014-09-24)
+------------------
+
+* Implemented new `[platformio] <http://docs.platformio.org/en/latest/projectconf.html#platformio>`_
+  section for Configuration File with `home_dir <http://docs.platformio.org/en/latest/projectconf.html#home-dir>`_
+  option (`issue #14 <https://github.com/ivankravets/platformio/issues/14>`_)
+* Implemented *Library Manager* (`issue #6 <https://github.com/ivankravets/platformio/issues/6>`_)
+
+0.6.0 (2014-08-09)
+------------------
+
+* Implemented `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ (`issue #10 <https://github.com/ivankravets/platformio/issues/10>`_)
+* Fixed an issue ``ImportError: No module named platformio.util`` (`issue #9 <https://github.com/ivankravets/platformio/issues/9>`_)
+* Fixed bug with auto-conversation from Arduino \*.ino to \*.cpp
 
 0.5.0 (2014-08-04)
 ------------------
@@ -12,27 +113,31 @@ Release History
 * Added auto-conversation from \*.ino to valid \*.cpp for Arduino/Energia
   frameworks (`issue #7 <https://github.com/ivankravets/platformio/issues/7>`_)
 * Added `Arduino example <https://github.com/ivankravets/platformio/tree/develop/examples/arduino-adafruit-library>`_
-  with external library (Adafruit CC3000)
-* Implemented ``platformio upgrade`` command and "auto-check" for the latest
+  with external library (*Adafruit CC3000*)
+* Implemented `platformio upgrade <http://docs.platformio.org/en/latest/userguide/cmd_upgrade.html>`_
+  command and "auto-check" for the latest
   version (`issue #8 <https://github.com/ivankravets/platformio/issues/8>`_)
-* Fixed issue with "auto-reset" for Raspduino board (thanks [David Mills](https://github.com/g7uvw) for testing)
-* Fixed bug with nested libs building (thanks [Antonio Vanegas](https://github.com/hpsaturn) for testing)
+* Fixed an issue with "auto-reset" for *Raspduino* board
+* Fixed a bug with nested libs building
 
 0.4.0 (2014-07-31)
 ------------------
 
-* Implemented ``serialports`` command
+* Implemented `platformio serialports <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html>`_ command
 * Allowed to put special build flags only for ``src`` files via
-  ``srcbuild_flags`` environment option
+  `srcbuild_flags <http://docs.platformio.org/en/latest/projectconf.html#srcbuild-flags>`_
+  environment option
 * Allowed to override some of settings via system environment variables
   such as: ``$PIOSRCBUILD_FLAGS`` and ``$PIOENVS_DIR``
-* Added ``--upload-port`` option for ``platformio run`` command
+* Added ``--upload-port`` option for `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html#cmdoption--upload-port>`__ command
 * Implemented (especially for `SmartAnthill <http://smartanthill.ikravets.com/>`_)
-  ``platformio run -t uploadlazy`` target (no dependencies to framework libs,
-  ELF and etc.)
-* Allowed to skip default packages via ``platformio install --skip-default-package`` flag
-* Added tools for Raspberry Pi platform
-* Added support for Microduino and Raspduino boards in ``atmelavr`` platform
+  `platformio run -t uploadlazy <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`_
+  target (no dependencies to framework libs, ELF and etc.)
+* Allowed to skip default packages via `platformio install --skip-default-package <http://docs.platformio.org/en/latest/userguide/cmd_install.html#cmdoption--skip-default>`_
+  option
+* Added tools for *Raspberry Pi* platform
+* Added support for *Microduino* and *Raspduino* boards in
+  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html>`_ platform
 
 
 0.3.1 (2014-06-21)

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014 Ivan Kravets
+Copyright (c) 2014-2015 Ivan Kravets
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.rst

@@ -17,616 +17,112 @@ PlatformIO
     :target: https://pypi.python.org/pypi/platformio/
     :alt:  License
 
-`Quickstart <#quickstart>`_ |
-`Installation <#installation>`_ |
-`Documentation <#documentation>`_ |
-`Examples <https://github.com/ivankravets/platformio/tree/develop/examples>`_ |
-`Embedded Platform Boards <#embedded-platform-boards>`_ |
-`IDE Integration <#ide-integration>`_ |
-`Blog <http://www.ikravets.com/category/computer-life/platformio>`_
+`Website + Library Search <http://platformio.org>`_ |
+`Documentation <http://docs.platformio.org>`_ |
+`Project Examples <https://github.com/ivankravets/platformio/tree/develop/examples>`_ |
+`Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
+`Twitter <https://twitter.com/PlatformIO_Org>`_
 
+.. image:: https://raw.githubusercontent.com/ivankravets/platformio/develop/docs/_static/platformio-logo.png
+    :target: http://platformio.org
 
-**PlatformIO** is a cross-platform code builder and library manager.
+`PlatformIO <http://platformio.org>`_ is a cross-platform code builder
+and the missing library manager.
 
-You have no need to install any *IDE* or compile any toolchains. *PlatformIO*
+* `Get Started <http://platformio.org/#!/get-started>`_
+* `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
+* `Development Platforms <http://platformio.org/#!/platforms>`_
+* `Embedded Boards <http://platformio.org/#!/boards>`_
+* `Library Manager <http://docs.platformio.org/en/latest/librarymanager/index.html>`_
+* `User Guide <http://docs.platformio.org/en/latest/userguide/index.html>`_
+* `IDE Integration <http://docs.platformio.org/en/latest/ide.html>`_
+* `Release History <http://docs.platformio.org/en/latest/history.html>`_
+
+You have **no need** to install any *IDE* or compile any tool chains. *PlatformIO*
 has pre-built different development platforms including: compiler, debugger,
-flasher (for embedded) and many other useful tools.
+uploader (for embedded boards) and many other useful tools.
 
-**PlatformIO** allows developer to compile the same code with different
-platforms using only one command ``platformio run``. This happens due to
-``platformio.ini`` project's file (see
-`default template <https://github.com/ivankravets/platformio/blob/develop/platformio/projectconftpl.ini>`_)
-where you can setup different environments with specific settings: platform,
-firmware uploading options, pre-built framework and many more.
+Use whenever. *Run everywhere.*
+-------------------------------
+*PlatformIO* is written in pure *Python* and **doesn't depend** on any
+additional libraries/tools from an operation system. It allows you to use
+*PlatformIO* beginning from *PC (Mac, Linux, Win)* and ending with credit-card
+sized computers (like *Raspberry Pi*).
 
-Each platform consists of packages which are located in own repository.
-Due to ``platformio update`` command you will have up-to-date development
-instruments.
+Embedded Development. *Easier Than Ever.*
+-----------------------------------------
+*PlatformIO* is well suited for embedded development and has pre-configured
+settings for most popular `Embedded Boards <http://platformio.org/#!/boards>`_.
 
-.. image:: examples/platformio-examples.png
-    :target: https://github.com/ivankravets/platformio/raw/develop/examples/platformio-examples.png
-    :alt:  Examples
-    :width: 730px
+* Colourful `command-line output <https://raw.githubusercontent.com/ivankravets/platformio/develop/examples/platformio-examples.png>`_
+* Built-in `Serial Port Monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_
+* Configurable `build -flags/-options <http://docs.platformio.org/en/latest/projectconf.html#build-flags>`_
+* Automatic **firmware uploading**
+* Integration with `development environments (IDE) <http://docs.platformio.org/en/latest/ide.html>`_
+* Ready for **cloud compilers**
+* Pre-built tool chains, frameworks for the popular `Hardware Platforms <http://platformio.org/#!/platforms>`_
 
-**PlatformIO** is well suited for **embedded development**. It can:
+.. image:: https://raw.githubusercontent.com/ivankravets/platformio-web/develop/app/images/platformio-embedded-development.png
+    :target: http://platformio.org
+    :alt:  PlatformIO Embedded Development Process
 
-* Automatically analyse dependency
-* Reliably detect build changes
-* Build framework or library source code to static library
-* Build *ELF* (executable and linkable firmware)
-* Convert *ELF* to *HEX* or *BIN* file
-* Extract *EEPROM* data
-* Upload firmware to your device
+The Missing Library Manager. *It's here!*
+-----------------------------------------
+*PlatformIO Library Manager* is the missing library manager for development
+platforms which allows you to organize and have up-to-date external libraries.
+
+* Friendly `Command-Line Interface <http://docs.platformio.org/en/latest/librarymanager/index.html>`_
+* Modern `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
+* Open Source `Library Registry API <https://github.com/ivankravets/platformio-api>`_
+* Library Crawler based on `library.json <http://docs.platformio.org/en/latest/librarymanager/config.html>`_
+  specification
+* Library **dependency management**
+* Automatic library updating
+
+.. image:: https://raw.githubusercontent.com/ivankravets/platformio-web/develop/app/images/platformio-library-manager.png
+    :target: http://platformio.org
+    :alt:  PlatformIO Library Manager Architecture
+
+Smart Code Builder. *Fast and Reliable.*
+----------------------------------------
+*PlatformIO Code Builder* is built-on a next-generation software construction
+tool named `SCons <http://www.scons.org/>`_. Think of *SCons* as an improved,
+cross-platform substitute for the classic *Make* utility.
+
+* Reliable, automatic *dependency analysis*
+* Reliable detection of *build changes*
+* Improved support for *parallel builds*
+* Ability to share *built files in a cache*
+* Lookup for external libraries which are installed via `Library Manager <http://docs.platformio.org/en/latest/librarymanager/index.html>`_
+
+.. image:: https://raw.githubusercontent.com/ivankravets/platformio-web/develop/app/images/platformio-scons-builder.png
+    :target: http://platformio.org
+    :alt:  PlatformIO Code Builder Architecture
+
+Single source code. *Multiple platforms.*
+-----------------------------------------
+*PlatformIO* allows developer to compile the same code with different
+development platforms using the *Only One Command*
+`platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`_.
+This happens due to
+`Project Configuration File (platformio.ini) <http://docs.platformio.org/en/latest/projectconf.html>`_
+where you can setup different environments with specific options (platform
+type, firmware uploading settings, pre-built framework, build flags and many
+more).
 
 It has support for many popular embedded platforms like these:
 
-* ``atmelavr`` `Atmel AVR <http://en.wikipedia.org/wiki/Atmel_AVR>`_
-  (including `Arduino <http://www.arduino.cc>`_ based boards)
-* ``timsp430`` `TI MSP430 <http://www.ti.com/lsds/ti/microcontroller/16-bit_msp430/overview.page>`_
-  (including `MSP430 LaunchPads <http://www.ti.com/ww/en/launchpad/launchpads-msp430.html>`_)
-* ``titiva`` `TI TIVA C <http://www.ti.com/lsds/ti/microcontroller/tiva_arm_cortex/c_series/overview.page>`_
-  (including `TIVA C Series LaunchPads <http://www.ti.com/ww/en/launchpad/launchpads-connected.html>`_)
-
-
-See project `examples with screenshots <https://github.com/ivankravets/platformio/tree/develop/examples>`_.
-
-
-IDE Integration
----------------
-
-* [Eclipse] `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_
-
-
-Embedded Platform Boards
-------------------------
-
-**PlatformIO** has pre-configured settings for most popular platform boards. You
-have no need to specify in ``platformio.ini`` type or frequency of MCU, upload
-protocol or etc. Please use ``board`` option (for
-`example <https://github.com/ivankravets/platformio/blob/develop/examples/wiring-blink/platformio.ini>`_).
-
-
-Platform ``atmelavr``
-~~~~~~~~~~~~~~~~~~~~~
-
-* ``diecimilaatmega168`` Arduino Duemilanove or Diecimila (ATmega168)
-* ``diecimilaatmega328`` Arduino Duemilanove or Diecimila (ATmega328)
-* ``fio`` Arduino Fio
-* ``leonardo`` Arduino Leonardo
-* ``LilyPadUSB`` Arduino LilyPad USB
-* ``lilypadatmega168`` Arduino LilyPad (ATmega168)
-* ``lilypadatmega328`` Arduino LilyPad (ATmega328)
-* ``megaatmega1280`` Arduino Mega (ATmega1280)
-* ``megaatmega2560`` Arduino Mega (ATmega2560)
-* ``megaADK`` Arduino Mega ADK
-* ``micro`` Arduino Micro
-* ``miniatmega168`` Arduino Mini (ATmega168)
-* ``miniatmega328`` Arduino Mini (ATmega328)
-* ``nanoatmega168`` Arduino Nano (ATmega168)
-* ``nanoatmega328`` Arduino Nano (ATmega328)
-* ``pro8MHzatmega168`` Arduino Pro or Pro Mini (ATmega168, 3.3V, 8MHz)
-* ``pro16MHzatmega168`` Arduino Pro or Pro Mini (ATmega168, 5V, 16MHz)
-* ``pro8MHzatmega328`` Arduino Pro or Pro Mini (ATmega328, 3.3V, 8MHz)
-* ``pro16MHzatmega328`` Arduino Pro or Pro Mini (ATmega328, 5V, 16MHz)
-* ``uno`` Arduino Uno
-* ``raspduino`` Raspduino
-* ``328p8m`` Microduino Core (ATmega328P, 3.3V, 8MHz)
-* ``328p16m`` Microduino Core (Atmega328P, 5V, 16MHz)
-* ``168pa8m`` Microduino Core (ATmega168PA, 3.3V, 8MHz)
-* ``168pa16m`` Microduino Core (ATmega168PA, 5V, 16MHz)
-* ``644pa8m`` Microduino Core+ (ATmega644PA, 3.3V, 8MHz)
-* ``644pa16m`` Microduino Core+ (ATmega644PA, 5V, 16MHz)
-* ``1284p8m`` Microduino-Core+ (ATmega1284P, 3.3V, 8MHz)
-* ``1284p16m`` Microduino-Core+ (ATmega1284P, 5V, 16MHz)
-* ``32u416m`` Microduino-Core USB (ATmega32U4, 5V, 16MHz)
-
-
-
-Platform ``timsp430``
-~~~~~~~~~~~~~~~~~~~~~
-
-* ``lpmsp430g2231`` TI LaunchPad MSP430 (msp430g2231)
-* ``lpmsp430g2452`` TI LaunchPad MSP430 (msp430g2452)
-* ``lpmsp430g2553`` TI LaunchPad MSP430 (msp430g2553)
-* ``lpmsp430f5529`` TI LaunchPad MSP430 (msp430f5529, 16MHz)
-* ``lpmsp430f5529_25`` TI LaunchPad MSP430 (msp430f5529, 25MHz)
-* ``lpmsp430fr5969`` TI LaunchPad MSP430 (msp430fr5969)
-* ``lpmsp430fr5739`` TI FraunchPad MSP430 (msp430fr5739)
-
-
-Platform ``titiva``
-~~~~~~~~~~~~~~~~~~~
-
-* ``lplm4f120h5qr`` TI Stellaris LM4F120 LaunchPad
-* ``lptm4c1230c3pm`` TI Tiva C Series TM4C123G LaunchPad
-* ``lptm4c1294ncpdt`` TI Tiva C Series TM4C1294 Connected LaunchPad
-
-
-Python & OS Support
--------------------
-
-**PlatformIO** is written in `Python <https://www.python.org>`_ and works with
-versions 2.6 and 2.7 on Unix/Linux, OS X, and Windows.
-
-
-Quickstart
-----------
-
-.. code-block:: bash
-
-    # Print all availalbe development platforms for installing
-    $ platformio search all
-
-    # Install new development platform
-    $ platformio install SomePlatform
-
-    # Initialize new platformio based project
-    $ cd /path/to/empty/directory
-    $ platformio init
-
-    # Process the project's environments
-    $ platformio run
-
-For more detailed information please follow to `Installation <#installation>`_
-and `Documentation <#documentation>`_ sections.
-
-
-Installation
-------------
-
-All commands below should be executed in
-`Command-line <http://en.wikipedia.org/wiki/Command-line_interface>`_
-application in your *OS*:
-
-* *Unix/Linux/OS X* this is *Terminal* application.
-* *Windows* this is
-  `Command Prompt <http://en.wikipedia.org/wiki/Command_Prompt>`_ (``cmd.exe``)
-  application.
-
-Also, the `Python Interpreter <https://www.python.org/downloads/>`_ (2.6 or 2.7)
-is required.
-
-
-Super-Quick
-~~~~~~~~~~~
-
-To install or upgrade *PlatformIO*, download
-`get-platformio.py <https://raw.githubusercontent.com/ivankravets/platformio/develop/scripts/get-platformio.py>`_ script.
-
-Then run the following (which may require administrator access):
-
-.. code-block:: bash
-
-    $ python get-platformio.py
-
-An alternative short version for *Mac/Linux* users:
-
-.. code-block:: bash
-
-    $ curl -L http://bit.ly/1lpanta | python
-
-
-On *Windows OS* it may look like:
-
-.. code-block:: bash
-
-    C:\Python27\python.exe get-platformio.py
-
-
-Full Guide
-~~~~~~~~~~
-
-1. Check a ``python`` version (only 2.6-2.7 is supported):
-
-.. code-block:: bash
-
-    $ python --version
-
-*Windows OS* Users only:
-
-    * `Download Python 2.7 <https://www.python.org/downloads/>`_ and install it.
-    * Add to PATH system variable ``;C:\Python27;C:\Python27\Scripts;`` and
-       reopen *Command Prompt* (``cmd.exe``) application. Please read this
-       article `How to set the path and environment variables in Windows
-       <http://www.computerhope.com/issues/ch000549.htm>`_.
-
-
-2. Check a ``pip`` tool for installing and managing *Python* packages:
-
-.. code-block:: bash
-
-    $ pip search platformio
-
-You should see short information about ``platformio`` package.
-
-If your computer does not recognize ``pip`` command, try to install it first
-using `these instructions <http://www.pip-installer.org/en/latest/installing.html>`_.
-
-3. Install a ``platformio`` and related packages:
-
-.. code-block:: bash
-
-    $ pip install platformio && pip install --egg scons
-
-For upgrading the ``platformio`` to new version please use this command:
-
-.. code-block:: bash
-
-    $ pip install -U platformio
-
-
-Documentation
--------------
-
-To print all available commands and options:
-
-.. code-block:: bash
-
-    $ platformio --help
-    $ platformio COMMAND --help
-
-    # Example
-    $ platformio --help
-    Usage: platformio [OPTIONS] COMMAND [ARGS]...
-
-    Options:
-      --version  Show the version and exit.
-      --help     Show this message and exit.
-
-    Commands:
-      init         Initialize new PlatformIO based project
-      install      Install new platforms
-      list         List installed platforms
-      run          Process project environments
-      search       Search for development platforms
-      serialports  List Serial ports
-      show         Show details about an installed platforms
-      uninstall    Uninstall platforms
-      update       Update installed platforms
-      upgrade      Upgrade PlatformIO to the latest version
-
-
-``platformio init``
-~~~~~~~~~~~~~~~~~~~
-
-Initialize new PlatformIO based project.
-
-.. code-block:: bash
-
-    # Change directory to future project
-    $ cd /path/to/empty/directory
-    $ platformio init
-
-    # Example
-    $ platformio init
-    Project has been initialized!
-    Please put your source code to `src` directory, external libraries to `lib`
-    and setup environments in `platformio.ini` file.
-    Then process project with `platformio run` command.
-
-After this command ``platformio`` will create:
-
-* ``.pioenvs`` - a temporary working directory.
-* ``lib`` - a directory for project specific libraries. PlatformIO will
-  compile their to static libraries and link to executable file
-* ``src`` - a source directory. Put code here.
-* ``platformio.ini`` - a configuration file for project
-
-
-``platformio install``
-~~~~~~~~~~~~~~~~~~~~~~
-
-*PlatformIO* has pre-built development platforms with related packages. You
-can install one of them:
-
-.. code-block:: bash
-
-    $ platformio install SomePlatform
-    $ platformio install SomePlatform --with-package=toolchain|uploader|PackageName
-    $ platformio install SomePlatform --without-package=toolchain|uploader|PackageName
-    $ platformio install SomePlatform --skip-default-package
-
-    # Example
-    $ platformio install timsp430
-    Installing toolchain-timsp430 package:
-    Downloading  [####################################]  100%
-    Unpacking  [####################################]  100%
-    Installing tool-mspdebug package:
-    Downloading  [####################################]  100%
-    Unpacking  [####################################]  100%
-    Installing framework-energiamsp430 package:
-    Downloading  [####################################]  100%
-    Unpacking  [####################################]  100%
-    The platform 'timsp430' has been successfully installed!
-
-    # Skip default packages and install uploader utility only
-    $ platformio install timsp430 --skip-default-package --with-package=uploader
-    Installing tool-mspdebug package:
-    Downloading  [####################################]  100%
-    Unpacking  [####################################]  100%
-    The platform 'timsp430' has been successfully installed!
-
-
-``platformio list``
-~~~~~~~~~~~~~~~~~~~
-
-To list installed platforms:
-
-.. code-block:: bash
-
-    $ platformio list
-
-    # Example
-    $ platformio list
-    timsp430    with packages: toolchain-timsp430, tool-mspdebug, framework-energiamsp430
-
-
-``platformio run``
-~~~~~~~~~~~~~~~~~~
-
-Process the project's environments defined in ``platformio.ini`` file:
-
-.. code-block:: bash
-
-    $ platformio run
-
-    # Example
-    $ platformio run
-    Processing arduino_pro5v environment:
-    scons: `.pioenvs/arduino_pro5v/firmware.elf' is up to date.
-    scons: `.pioenvs/arduino_pro5v/firmware.hex' is up to date.
-
-    Processing launchpad_msp430g2 environment:
-    scons: `.pioenvs/launchpad_msp430g2/firmware.elf' is up to date.
-    scons: `.pioenvs/launchpad_msp430g2/firmware.hex' is up to date.
-
-    Processing launchpad_lm4f120 environment:
-    scons: `.pioenvs/launchpad_lm4f120/firmware.elf' is up to date.
-    scons: `.pioenvs/launchpad_lm4f120/firmware.hex' is up to date
-
-Process specific environments:
-
-.. code-block:: bash
-
-    $ platformio run -e myenv1 -e myenv2
-
-    # Example
-    $ platformio run -e arduino_pro5v -e launchpad_lm4f120
-    Processing arduino_pro5v environment:
-    scons: `.pioenvs/arduino_pro5v/firmware.elf' is up to date.
-    scons: `.pioenvs/arduino_pro5v/firmware.hex' is up to date.
-
-    Processing launchpad_lm4f120 environment:
-    scons: `.pioenvs/launchpad_lm4f120/firmware.elf' is up to date.
-    scons: `.pioenvs/launchpad_lm4f120/firmware.hex' is up to date.
-
-Process specific target:
-
-.. code-block:: bash
-
-    $ platformio run -t clean
-    $ platformio run -t upload --upload-port=/dev/ttyUSBX
-
-    # Example
-    platformio run -t clean
-    Processing arduino_pro5v environment:
-    Removed .pioenvs/arduino_pro5v/src/main.o
-    ...
-    Removed .pioenvs/arduino_pro5v/firmware.hex
-
-    Processing launchpad_msp430g2 environment:
-    Removed .pioenvs/launchpad_msp430g2/src/main.o
-    ...
-    Removed .pioenvs/launchpad_msp430g2/firmware.hex
-
-    Processing launchpad_lm4f120 environment:
-    Removed .pioenvs/launchpad_lm4f120/src/main.o
-    ...
-    Removed .pioenvs/launchpad_lm4f120/firmware.hex
-
-Mix environments and targets:
-
-.. code-block:: bash
-
-    $ platformio run -e myembeddeddevice -t upload
-
-    # Example
-    $ platformio run -e launchpad_msp430g2 -t upload
-    Processing launchpad_msp430g2 environment:
-    /Users/ikravets/.platformio/timsp430/tools/mspdebug/mspdebug rf2500 --force-reset "prog .pioenvs/launchpad_msp430g2/firmware.hex"
-    MSPDebug version 0.20 - debugging tool for MSP430 MCUs
-    Copyright (C) 2009-2012 Daniel Beer <dlbeer@gmail.com>
-    This is free software; see the source for copying conditions.  There is NO
-    warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-
-    Trying to open interface 1 on 009
-    Initializing FET...
-    FET protocol version is 30394216
-    Configured for Spy-Bi-Wire
-    Sending reset...
-    Set Vcc: 3000 mV
-    Device ID: 0x2553
-      Code start address: 0xc000
-      Code size         : 16384 byte = 16 kb
-      RAM  start address: 0x200
-      RAM  end   address: 0x3ff
-      RAM  size         : 512 byte = 0 kb
-    Device: MSP430G2553/G2403
-    Code memory starts at 0xc000
-    Number of breakpoints: 2
-    Chip ID data: 25 53
-    Erasing...
-    Programming...
-    Writing  646 bytes at c000...
-    Writing   32 bytes at ffe0...
-    Done, 678 bytes total
-
-
-``platformio search``
-~~~~~~~~~~~~~~~~~~~~~
-
-Search for development platforms:
-
-.. code-block:: bash
-
-    # Print all available development platforms
-    $ platformio search all
-
-    # Filter platforms by "Query"
-    $ platformio search "Query"
-
-    # Example
-    $ platformio search ti
-    timsp430 - An embedded platform for TI MSP430 microcontrollers (with Energia Framework)
-    titiva   - An embedded platform for TI TIVA C ARM microcontrollers (with Energia Framework)
-
-    $ platformio search arduino
-    atmelavr - An embedded platform for Atmel AVR microcontrollers (with Arduino Framework)
-
-
-``platformio serialports``
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To list available `Serial Ports <http://en.wikipedia.org/wiki/Serial_port>`_:
-
-.. code-block:: bash
-
-    $ platformio serialports
-
-    # Example (Posix)
-    $ platformio serialports
-    /dev/cu.SLAB_USBtoUART
-    ----------
-    Hardware ID: USB VID:PID=10c4:ea60 SNR=0001
-    Description: CP2102 USB to UART Bridge Controller
-
-    /dev/cu.uart-1CFF4676258F4543
-    ----------
-    Hardware ID: USB VID:PID=451:f432 SNR=1CFF4676258F4543
-    Description: Texas Instruments MSP-FET430UIF
-
-    # Example (Windows)
-    $ platformio serialports
-    COM4
-    ----------
-    Hardware ID: USB VID:PID=0451:F432
-    Description: MSP430 Application UART (COM4)
-
-    COM3
-    ----------
-    Hardware ID: USB VID:PID=10C4:EA60 SNR=0001
-    Description: Silicon Labs CP210x USB to UART Bridge (COM3)
-
-
-``platformio show``
-~~~~~~~~~~~~~~~~~~~
-
-To show details about an installed platform:
-
-.. code-block:: bash
-
-    $ platformio show SomePlatform
-
-    # Example
-    $ platformio show atmelavr
-    atmelavr    - An embedded platform for Atmel AVR microcontrollers (with Arduino Framework)
-    ----------
-    Package: toolchain-atmelavr
-    Alias: toolchain
-    Location: /Users/ikravets/.platformio/atmelavr/tools/toolchain
-    Version: 1
-    ----------
-    Package: tool-avrdude
-    Alias: uploader
-    Location: /Users/ikravets/.platformio/atmelavr/tools/avrdude
-    Version: 1
-    ----------
-    Package: framework-arduinoavr
-    Location: /Users/ikravets/.platformio/atmelavr/frameworks/arduino
-    Version: 1
-
-
-``platformio uninstall``
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-To uninstall platform:
-
-.. code-block:: bash
-
-    $ platformio uninstall SomePlatform
-
-    # Example
-    $ platformio uninstall timsp430
-    Uninstalling toolchain-timsp430 package:        [OK]
-    Uninstalling tool-mspdebug package:             [OK]
-    Uninstalling framework-energiamsp430 package:   [OK]
-    The platform 'timsp430' has been successfully uninstalled!
-
-
-``platformio update``
-~~~~~~~~~~~~~~~~~~~~~
-
-To check or update installed platforms:
-
-.. code-block:: bash
-
-    $ platformio update
-
-    # Example
-    $ platformio update
-
-    Platform atmelavr
-    --------
-    Updating toolchain-atmelavr package:
-    Versions: Current=1, Latest=1 	 [Up-to-date]
-    Updating framework-arduinoavr package:
-    Versions: Current=1, Latest=1 	 [Up-to-date]
-    Updating tool-avrdude package:
-    Versions: Current=1, Latest=1 	 [Up-to-date]
-
-    Platform timsp430
-    --------
-    Updating toolchain-timsp430 package:
-    Versions: Current=1, Latest=1 	 [Up-to-date]
-    Updating tool-mspdebug package:
-    Versions: Current=1, Latest=1 	 [Up-to-date]
-    Updating framework-energiamsp430 package:
-    Versions: Current=1, Latest=1 	 [Up-to-date]
-
-    Platform titiva
-    --------
-    Updating toolchain-gccarmnoneeabi package:
-    Versions: Current=1, Latest=1 	 [Up-to-date]
-    Updating tool-lm4flash package:
-    Versions: Current=1, Latest=1 	 [Up-to-date]
-    Updating framework-energiativa package:
-    Versions: Current=1, Latest=1 	 [Up-to-date]
-
-
-``platformio upgrade``
-~~~~~~~~~~~~~~~~~~~~~~
-
-To check or upgrade PlatformIO to the latest version:
-
-.. code-block:: bash
-
-    $ platformio upgrade
-
-    # If you have problem with permissions try:
-    $ sudo platformio upgrade
-
-
-Questions & Bugs
-----------------
-
-Please use the
-`issue tracker <https://github.com/ivankravets/platformio/issues>`_
-to ask questions or report bugs.
+* ``atmelavr`` `Atmel AVR <http://platformio.org/#!/platforms/atmelavr>`_
+  (including *Arduino*-based boards, *Microduino, Raspduino, Teensy*)
+* ``timsp430`` `TI MSP430 <http://platformio.org/#!/platforms/timsp430>`_
+  (including *MSP430* LaunchPads)
+* ``titiva`` `TI TIVA C <http://platformio.org/#!/platforms/titiva>`_
+  (including *TIVA C* Series LaunchPads)
 
 
 Licence
 -------
 
-Copyright (C) 2014 Ivan Kravets
+Copyright (C) 2014-2015 Ivan Kravets
 
 Licenced under the MIT Licence.

docs/Makefile

@@ -0,0 +1,177 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# User-friendly check for sphinx-build
+ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
+$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
+endif
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  xml        to make Docutils-native XML files"
+	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/PlatformIO.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/PlatformIO.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/PlatformIO"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/PlatformIO"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+latexpdfja:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through platex and dvipdfmx..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."
+
+xml:
+	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
+	@echo
+	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
+
+pseudoxml:
+	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
+	@echo
+	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."

docs/conf.py

@@ -0,0 +1,278 @@
+# -*- coding: utf-8 -*-
+#
+# PlatformIO documentation build configuration file, created by
+# sphinx-quickstart on Sun Aug  3 19:13:49 2014.
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import os
+import sys
+
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(os.pardir))
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = []
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix of source filenames.
+source_suffix = '.rst'
+
+# The encoding of source files.
+#source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = u'PlatformIO'
+copyright = u'2014-2015, Ivan Kravets'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+import platformio
+# The short X.Y version.
+version = '.'.join(map(str, platformio.VERSION[0:2]))
+# The full version, including alpha/beta/rc tags.
+release = platformio.__version__
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+#today = ''
+# Else, today_fmt is used as the format for a strftime call.
+#today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ['_build']
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+#default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+#add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+#add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+#show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# A list of ignored prefixes for module index sorting.
+#modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+#keep_warnings = False
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = 'default'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#html_theme_options = {}
+
+# Add any paths that contain custom themes here, relative to this directory.
+#html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+#html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+#html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+#html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+#html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+#html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+#html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+#html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+#html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+#html_additional_pages = {}
+
+# If false, no module index is generated.
+#html_domain_indices = True
+
+# If false, no index is generated.
+#html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+#html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+#html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+#html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+#html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+#html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+#html_file_suffix = None
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'PlatformIOdoc'
+
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+# The paper size ('letterpaper' or 'a4paper').
+#'papersize': 'letterpaper',
+
+# The font size ('10pt', '11pt' or '12pt').
+#'pointsize': '10pt',
+
+# Additional stuff for the LaTeX preamble.
+#'preamble': '',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+  ('index', 'PlatformIO.tex', u'PlatformIO Documentation',
+   u'Ivan Kravets', 'manual'),
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+#latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+#latex_use_parts = False
+
+# If true, show page references after internal links.
+#latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+#latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+#latex_appendices = []
+
+# If false, no module index is generated.
+#latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    ('index', 'platformio', u'PlatformIO Documentation',
+     [u'Ivan Kravets'], 1)
+]
+
+# If true, show URL addresses after external links.
+#man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+  ('index', 'PlatformIO', u'PlatformIO Documentation',
+   u'Ivan Kravets', 'PlatformIO', 'One line description of project.',
+   'Miscellaneous'),
+]
+
+# Documents to append as an appendix to all manuals.
+#texinfo_appendices = []
+
+# If false, no module index is generated.
+#texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+#texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+#texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+#intersphinx_mapping = {'http://docs.python.org/': None}
+
+# Read the Docs Sphinx Theme patch
+# on_rtd is whether we are on readthedocs.org,
+# this line of code grabbed from docs.readthedocs.org
+on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
+if not on_rtd:  # only import and set the theme if we're building docs locally
+    import sphinx_rtd_theme
+    html_theme = 'sphinx_rtd_theme'
+    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+
+# A timeout value, in seconds, for the linkcheck builder
+# http://sphinx-doc.org/config.html#confval-linkcheck_timeout
+linkcheck_timeout = 10
+linkcheck_anchors = False

docs/history.rst

@@ -0,0 +1 @@
+.. include:: ../HISTORY.rst

docs/ide.rst

@@ -0,0 +1,60 @@
+.. _ide:
+
+IDE Integration
+===============
+
+Arduino IDE
+-----------
+
+.. image:: _static/ide-platformio-arduino.png
+    :target: http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides
+
+* `Integration of PlatformIO library manager to Arduino IDE <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_
+
+Eclipse
+-------
+
+
+.. image:: _static/ide-platformio-eclipse.png
+    :target: http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio
+
+* `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_
+* `More examples (TI MSP430, TI TIVA and etc) <https://github.com/ivankravets/platformio/tree/develop/examples/ide-eclipse>`_
+
+Energia IDE
+-----------
+
+.. image:: _static/ide-platformio-energia.png
+    :target: http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides
+
+* `Integration of PlatformIO library manager to Energia IDE <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_
+
+VIM
+---
+
+.. image:: _static/ide-platformio-vim.png
+
+Recommended bundles:
+
+* Syntax highlight - `Arduino-syntax-file <https://github.com/vim-scripts/Arduino-syntax-file>`_
+* Code Completion - `YouCompleteMe <https://github.com/Valloric/YouCompleteMe>`_
+* Syntax checking - `Syntastic <https://github.com/scrooloose/syntastic>`_
+
+Put to the project directory ``Makefile`` wrapper with contents:
+
+.. code-block:: make
+
+    # Uncomment lines below if you have problems with $PATH
+    #SHELL := /bin/bash
+    #PATH := /usr/local/bin:$(PATH)
+
+    all:
+        platformio run -t upload
+
+    clean:
+        platformio run -t clean
+
+
+Now, in VIM ``cd /path/to/this/project`` and press ``Ctrl+B`` or ``Cmd+B``
+(Mac). *PlatformIO* should compile your source code from the ``src`` directory,
+make firmware and upload it.

docs/index.rst

@@ -0,0 +1,50 @@
+PlatformIO: A cross-platform code builder and the missing library manager
+=========================================================================
+
+.. image:: _static/platformio-logo.png
+    :target: http://platformio.org
+
+`Website + Library Search <http://platformio.org>`_ |
+`Project Examples <https://github.com/ivankravets/platformio/tree/develop/examples>`_ |
+`Source Code <https://github.com/ivankravets/platformio>`_ |
+`Issues <https://github.com/ivankravets/platformio/issues>`_ |
+`Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
+`Twitter <https://twitter.com/PlatformIO_Org>`_
+
+You have no need to install any *IDE* or compile any tool chains. *PlatformIO*
+has pre-built different development platforms including: compiler, debugger,
+uploader (for embedded) and many other useful tools.
+
+**PlatformIO** allows developer to compile the same code with different
+platforms using only one command :ref:`cmd_run`. This happens due to
+:ref:`projectconf` where you can setup different environments with specific
+options: platform type, firmware uploading settings, pre-built framework
+and many more.
+
+Each platform consists of packages which are located in own repository.
+Due to :ref:`cmd_update` command you will have up-to-date development
+instruments.
+
+**PlatformIO** is well suited for **embedded development**. It can:
+
+* Automatically analyse dependency
+* Reliably detect build changes
+* Build framework or library source code to static library
+* Lookup for external libraries which are installed via :ref:`librarymanager`
+* Upload firmware to your device
+
+
+Contents
+--------
+
+.. toctree::
+    :maxdepth: 2
+
+    quickstart
+    installation
+    projectconf
+    platforms/index
+    librarymanager/index
+    userguide/index
+    ide
+    history

docs/installation.rst

@@ -0,0 +1,113 @@
+.. _installation:
+
+Installation
+============
+
+*PlatformIO* is written in `Python <http://python.org/download/>`_ and works
+on *Mac OS X*, *Linux*, *Windows OS* and Credit-card *ARM*-based
+computers (*Raspberry Pi*).
+
+System requirements
+-------------------
+
+* **Operating systems:**
+    * Mac OS X
+    * Linux
+    * Windows
+* `Python 2.6 or Python 2.7 <http://python.org/download/>`_
+
+All commands below should be executed in
+`Command-line <http://en.wikipedia.org/wiki/Command-line_interface>`_
+application:
+
+* *Mac OS X / Linux* this is *Terminal* application.
+* *Windows* this is
+  `Command Prompt <http://en.wikipedia.org/wiki/Command_Prompt>`_ (``cmd.exe``)
+  application.
+
+.. warning::
+    If you are going to use *PlatformIO* for "*Cloud Compiling*", please
+    don't forget to turn off :ref:`enable_prompts <cmd_settings>` setting. It
+    will allow you to avoid blocking when call ``platformio`` like subprocess.
+
+Please *choose one of* the following:
+
+Super-Quick (Mac / Linux)
+-------------------------
+
+To install or upgrade *PlatformIO* paste that at a *Terminal* prompt
+(you might need to run ``sudo`` first):
+
+.. code-block:: bash
+
+    python -c "$(curl -fsSL https://raw.githubusercontent.com/ivankravets/platformio/master/scripts/get-platformio.py)"
+
+
+Installer Script (Mac / Linux / Windows)
+----------------------------------------
+
+To install or upgrade *PlatformIO*, download
+`get-platformio.py <https://raw.githubusercontent.com/ivankravets/platformio/develop/scripts/get-platformio.py>`_
+script. Then run the following (you might need to run ``sudo`` first):
+
+.. code-block:: bash
+
+    python get-platformio.py
+
+
+On *Windows OS* it may look like:
+
+.. code-block:: bash
+
+    C:\Python27\python.exe get-platformio.py
+
+.. warning::
+    **Mac OS Users**: If you have an error ``pkg_resources.DistributionNotFound`` please
+    upgrade *SetupTools* package: ``$ [sudo] pip uninstall setuptools``
+    and ``$ [sudo] pip install setuptools``.
+    Then re-install *PlatformIO*: ``$ [sudo] pip uninstall platformio``
+    and ``$ [sudo] pip install platformio``.
+
+
+Full Guide
+----------
+
+1. Check a ``python`` version (only 2.6-2.7 is supported):
+
+.. code-block:: bash
+
+    $ python --version
+
+*Windows OS* Users only:
+
+    * `Download Python 2.7 <https://www.python.org/downloads/>`_ and install it.
+    * Add to PATH system variable ``;C:\Python27;C:\Python27\Scripts;`` and
+       reopen *Command Prompt* (``cmd.exe``) application. Please read this
+       article `How to set the path and environment variables in Windows
+       <http://www.computerhope.com/issues/ch000549.htm>`_.
+
+
+2. Check a ``pip`` tool for installing and managing *Python* packages:
+
+.. code-block:: bash
+
+    $ pip search platformio
+
+You should see short information about ``platformio`` package.
+
+If your computer does not recognize ``pip`` command, try to install it first
+using `these instructions <https://pip.pypa.io/en/latest/installing.html>`_.
+
+3. Install a ``platformio`` and related packages:
+
+.. code-block:: bash
+
+    $ pip install platformio && pip install --egg scons
+
+For upgrading the ``platformio`` to new version please use this command:
+
+.. code-block:: bash
+
+    $ pip install -U platformio
+
+

docs/librarymanager/config.rst

@@ -0,0 +1,307 @@
+.. |PIOAPICR| replace:: *PlatformIO Library Registry Crawler*
+.. _library_config:
+
+library.json
+============
+
+``library.json`` is a manifest file of development library.
+
+Initially it was
+developed for :ref:`librarymanager`, but later was accepted by worldwide embedded
+community like a **standard library specification**.
+
+A data in ``library.json`` should be represented
+in `JSON-style <http://en.wikipedia.org/wiki/JSON>`_ via
+`associative array <http://en.wikipedia.org/wiki/Associative_array>`_
+(name/value pairs). An order doesn't matter. The allowable fields
+(names from pairs) are described below.
+
+.. contents::
+
+.. _libjson_name:
+
+``name``
+--------
+
+**Required** | Type: ``String`` | Max. Length: 50
+
+A name of the library.
+
+* Must be unique.
+* Should be slug style for simplicity, consistency and compatibility.
+  Example: *Arduino-SPI*
+* Title Case, Aa-z, can contain digits and dashes (but not start/end
+  with them).
+* Consecutive dashes are not allowed.
+
+
+.. _libjson_description:
+
+``description``
+---------------
+
+**Required** | Type: ``String`` | Max. Length: 255
+
+The field helps users to identify and search for your library with a brief
+description. Describe the hardware devices (sensors, boards and etc.) which
+are suitable with it.
+
+
+.. _libjson_keywords:
+
+``keywords``
+------------
+
+**Required** | Type: ``String`` | Max. Length: 255
+
+Used for search by keyword. Helps to make your library easier to discover
+without people needing to know its name.
+
+The keyword should be lowercased, can contain a-z, digits and dash (but not
+start/end with them). A list from the keywords can be specified with
+separator ``,``
+
+
+.. _libjson_authors:
+
+``authors``
+-----------
+
+*Required* if :ref:`libjson_repository` field is not defined | Type: ``Object``
+or ``Array``
+
+An author contact information
+
+* ``name`` Full name (**Required**)
+* ``email``
+* ``url`` An author's contact page
+* ``maintainer`` Specify "maintainer" status
+
+Examples:
+
+.. code-block:: javascript
+
+    "authors":
+    {
+        "name": "John Smith",
+        "email": "me@john-smith.com",
+        "url": "http://www.john-smith/contact"
+    }
+
+    ...
+
+    "authors":
+    [
+        {
+            "name": "John Smith",
+            "email": "me@john-smith.com",
+            "url": "http://www.john-smith/contact"
+        },
+        {
+            "name": "Andrew Smith",
+            "email": "me@andrew-smith.com",
+            "url": "http://www.andrew-smith/contact",
+            "maintainer": true
+        }
+    ]
+
+
+.. note::
+    You can omit :ref:`libjson_authors` field and define
+    :ref:`libjson_repository` field. Only *GitHub-based* repository is
+    supported now. In this case
+    |PIOAPICR| will use information from
+    `GitHub API Users <https://developer.github.com/v3/users/>`_.
+
+
+.. _libjson_repository:
+
+``repository``
+--------------
+
+*Required* if :ref:`libjson_downloadurl` field is not defined | Type: ``Object``
+
+The repository in which the source code can be found.
+
+Example:
+
+.. code-block:: javascript
+
+    "repository":
+    {
+        "type": "git",
+        "url": "https://github.com/foo/bar.git"
+    }
+
+
+.. _libjson_downloadurl:
+
+``downloadUrl``
+---------------
+
+*Required* if :ref:`libjson_repository` field is not defined | Type: ``String``
+
+It is the *HTTP URL* to the archived source code of library. It should end
+with the type of archive (``.zip`` or ``.tar.gz``).
+
+
+.. _libjson_version:
+
+``version``
+-----------
+
+*Required* if :ref:`libjson_repository` field is not defined | Type: ``String``
+| Max. Length: 20
+
+A version of the current library source code.
+
+* Can contain a-z, digits, dots or dash.
+* `Semantic Versioning <http://semver.org>`_ is recommended.
+* A `CVS <http://en.wikipedia.org/wiki/Concurrent_Versions_System>`_
+  revision from the latest commit. Example: ``13`` (*SVN*) or first 10
+  chars of *SHA* digest ``e4564b7da4`` (*Git*).
+
+.. note::
+    You can omit :ref:`libjson_version` field and define
+    :ref:`libjson_repository` field. In this case
+    |PIOAPICR| will use the *CVS*-revision from the latest commit.
+
+
+.. _libjson_include:
+
+``include``
+-----------
+
+*Optional* | Type: ``String`` or ``Array`` |
+`Glob Pattern <http://en.wikipedia.org/wiki/Glob_(programming)>`_
+
+If :ref:`libjson_include` field is a type of ``String``, then
+|PIOAPICR| will recognize it like a "relative path inside
+repository/archive to library source code". See example below where the only
+source code from the relative directory ``LibrarySourceCodeHere`` will be
+included.
+
+.. code-block:: javascript
+
+    "include": "some/child/dir/LibrarySourceCodeHere"
+
+If :ref:`libjson_include` field is a type of ``Array``, then
+|PIOAPICR| firstly will apply :ref:`libjson_exclude` filter and
+then include only directories/files which match with :ref:`libjson_include`
+patterns.
+
+Example:
+
+.. code-block:: javascript
+
+    "include":
+    [
+        "dir/*.[ch]pp",
+        "dir/examples/*",
+        "*/*/*.h"
+    ]
+
+Pattern	Meaning
+
+.. list-table::
+    :header-rows:  1
+
+    * - Pattern
+      - Meaning
+    * - ``*``
+      - matches everything
+    * - ``?``
+      - matches any single character
+    * - ``[seq]``
+      - matches any character in seq
+    * - ``[!seq]``
+      - matches any character not in seq
+
+
+.. _libjson_exclude:
+
+``exclude``
+-----------
+
+*Optional* | Type: ``String`` or ``Array`` |
+`Glob Pattern <http://en.wikipedia.org/wiki/Glob_(programming)>`_
+
+Exclude the directories and files which match with :ref:`libjson_exclude`
+patterns.
+
+.. _libjson_frameworks:
+
+``frameworks``
+--------------
+
+*Optional* | Type: ``String`` or ``Array``
+
+A list with compatible frameworks. The available framework types are defined in
+the :ref:`platforms` section.
+
+
+.. _libjson_platforms:
+
+``platforms``
+-------------
+
+*Optional* | Type: ``String`` or ``Array``
+
+A list with compatible platforms. The available platform types are
+defined in :ref:`platforms` section.
+
+
+.. _libjson_dependencies:
+
+``dependencies``
+----------------
+
+*Optional* | Type: ``Array`` or ``Object``
+
+A list of dependent libraries. They will be installed automatically with
+:ref:`cmd_lib_install` command.
+
+Allowed requirements for dependent library:
+
+* ``name`` | Type: ``String``
+* ``authors`` | Type: ``String`` or ``Array``
+* ``frameworks`` | Type: ``String`` or ``Array``
+* ``platforms`` | Type: ``String`` or ``Array``
+
+Example:
+
+.. code-block:: javascript
+
+    "dependencies":
+    [
+        {
+            "name": "Library-Foo",
+            "authors":
+            [
+                "Jhon Smith",
+                "Andrew Smith"
+            ]
+        },
+        {
+            "name": "Library-Bar",
+            "frameworks": "FrameworkFoo, FrameworkBar"
+        }
+    ]
+
+
+.. _libjson_examples:
+
+``examples``
+----------------
+
+*Optional* | Type: ``String`` or ``Array`` |
+`Glob Pattern <http://en.wikipedia.org/wiki/Glob_(programming)>`_
+
+A list of example patterns. This field is predefined with default value:
+
+.. code-block:: javascript
+
+    "examples": [
+        "[Ee]xamples/*/*.ini",
+        "[Ee]xamples/*/*.pde"
+    ]

docs/librarymanager/creating.rst

@@ -0,0 +1,136 @@
+.. _library_creating:
+.. |PIOAPICR| replace:: *PlatformIO Library Registry Crawler*
+
+Creating Library
+================
+
+*PlatformIO* :ref:`librarymanager` doesn't have any requirements to a library
+source code structure. The only one requirement is library's manifest file -
+:ref:`library_config`. It can be located inside your library or in the another
+location where |PIOAPICR| will have *HTTP* access.
+
+.. contents::
+
+Source Code Location
+--------------------
+
+There are a several ways how to share your library with the whole world
+(see `examples <https://github.com/ivankravets/platformio-libmirror/tree/master/configs>`_).
+
+You can hold a lot of libraries (split into separated folders) inside one of
+the repository/archive. In this case please use :ref:`libjson_include`
+field to specify the relative path to your library's source code.
+
+
+At GitHub
+^^^^^^^^^
+
+**Recommended**
+
+If a library source code is located at `GitHub <https://github.com>`_, then
+you **need to specify** only these fields in the :ref:`library_config`:
+
+* :ref:`libjson_name`
+* :ref:`libjson_keywords`
+* :ref:`libjson_description`
+* :ref:`libjson_repository`
+
+|PIOAPICR| will populate the rest fields, like :ref:`libjson_version` or
+:ref:`libjson_authors` with an actual information from *GitHub*.
+
+Example:
+
+.. code-block:: javascript
+
+    {
+        "name": "IRremote",
+        "keywords": "infrared, ir, remote",
+        "description": "Send and receive infrared signals with multiple protocols",
+        "repository":
+        {
+            "type": "git",
+            "url": "https://github.com/shirriff/Arduino-IRremote.git"
+        },
+        "frameworks": "arduino",
+        "platforms": "atmelavr"
+    }
+
+Under CVS (SVN/GIT)
+^^^^^^^^^^^^^^^^^^^
+
+|PIOAPICR| can operate with a library source code that is under *CVS* control.
+The list of **required** fields in the :ref:`library_config` will look like:
+
+* :ref:`libjson_name`
+* :ref:`libjson_keywords`
+* :ref:`libjson_description`
+* :ref:`libjson_authors`
+* :ref:`libjson_repository`
+
+Example:
+
+.. code-block:: javascript
+
+    {
+        "name": "XBee",
+        "keywords": "xbee, protocol, radio",
+        "description": "Arduino library for communicating with XBees in API mode",
+        "authors":
+        {
+            "name": "Andrew Rapp",
+            "email": "andrew.rapp@gmail.com",
+            "url": "https://code.google.com/u/andrew.rapp@gmail.com/"
+        },
+        "repository":
+        {
+            "type": "git",
+            "url": "https://code.google.com/p/xbee-arduino/"
+        },
+        "frameworks": "arduino",
+        "platforms": "atmelavr"
+    }
+
+Self-hosted
+^^^^^^^^^^^
+
+You can manually archive (*Zip, Tar.Gz*) your library source code and host it
+in the *Internet*. Then you should specify the additional fields,
+like :ref:`libjson_version` and :ref:`libjson_downloadurl`. The final list
+of **required** fields in the :ref:`library_config` will look like:
+
+* :ref:`libjson_name`
+* :ref:`libjson_keywords`
+* :ref:`libjson_description`
+* :ref:`libjson_authors`
+* :ref:`libjson_version`
+* :ref:`libjson_downloadurl`
+
+.. code-block:: javascript
+
+    {
+        "name": "OneWire",
+        "keywords": "onewire, 1-wire, bus, sensor, temperature, ibutton",
+        "description": "Control devices (from Dallas Semiconductor) that use the One Wire protocol (DS18S20, DS18B20, DS2408 and etc)",
+        "authors":
+        {
+            "name": "Paul Stoffregen",
+            "url": "http://www.pjrc.com/teensy/td_libs_OneWire.html"
+        },
+        "version": "2.2",
+        "downloadUrl": "http://www.pjrc.com/teensy/arduino_libraries/OneWire.zip",
+        "include": "OneWire",
+        "frameworks": "arduino",
+        "platforms": "atmelavr"
+    }
+
+
+Register
+--------
+
+The registration requirements:
+
+* A library must adhere to the :ref:`library_config` specification.
+* There must be public *HTTP* access to the library :ref:`library_config` file.
+
+Now, you can :ref:`register <cmd_lib_register>` your library and allow others
+to :ref:`install <cmd_lib_install>` it.

docs/librarymanager/index.rst

@@ -0,0 +1,25 @@
+.. _librarymanager:
+
+Library Manager
+===============
+
+..
+
+    *"The missing library manager for development platforms"* [#]_
+
+*PlatformIO Library Manager* allows you to organize external embedded libraries.
+You can search for new libraries via :ref:`Command Line interface <cmd_lib_search>`
+or `Web 2.0 Library Search <http://platformio.org/#!/lib>`_.
+
+You don't need to bother for finding the latest version of library. Due to
+:ref:`cmd_lib_update` command you will have up-to-date external libraries.
+
+.. toctree::
+    :maxdepth: 2
+
+    config
+    creating
+    User Guide <../userguide/lib/index.rst>
+
+.. [#] Inspired by `npm <https://www.npmjs.org>`_ and `bower
+    <http://bower.io>`_ package managers for web.

docs/make.bat

@@ -0,0 +1,242 @@
+@ECHO OFF
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set BUILDDIR=_build
+set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
+set I18NSPHINXOPTS=%SPHINXOPTS% .
+if NOT "%PAPER%" == "" (
+	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
+	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
+)
+
+if "%1" == "" goto help
+
+if "%1" == "help" (
+	:help
+	echo.Please use `make ^<target^>` where ^<target^> is one of
+	echo.  html       to make standalone HTML files
+	echo.  dirhtml    to make HTML files named index.html in directories
+	echo.  singlehtml to make a single large HTML file
+	echo.  pickle     to make pickle files
+	echo.  json       to make JSON files
+	echo.  htmlhelp   to make HTML files and a HTML help project
+	echo.  qthelp     to make HTML files and a qthelp project
+	echo.  devhelp    to make HTML files and a Devhelp project
+	echo.  epub       to make an epub
+	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
+	echo.  text       to make text files
+	echo.  man        to make manual pages
+	echo.  texinfo    to make Texinfo files
+	echo.  gettext    to make PO message catalogs
+	echo.  changes    to make an overview over all changed/added/deprecated items
+	echo.  xml        to make Docutils-native XML files
+	echo.  pseudoxml  to make pseudoxml-XML files for display purposes
+	echo.  linkcheck  to check all external links for integrity
+	echo.  doctest    to run all doctests embedded in the documentation if enabled
+	goto end
+)
+
+if "%1" == "clean" (
+	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
+	del /q /s %BUILDDIR%\*
+	goto end
+)
+
+
+%SPHINXBUILD% 2> nul
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+if "%1" == "html" (
+	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
+	goto end
+)
+
+if "%1" == "dirhtml" (
+	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
+	goto end
+)
+
+if "%1" == "singlehtml" (
+	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
+	goto end
+)
+
+if "%1" == "pickle" (
+	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished; now you can process the pickle files.
+	goto end
+)
+
+if "%1" == "json" (
+	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished; now you can process the JSON files.
+	goto end
+)
+
+if "%1" == "htmlhelp" (
+	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished; now you can run HTML Help Workshop with the ^
+.hhp project file in %BUILDDIR%/htmlhelp.
+	goto end
+)
+
+if "%1" == "qthelp" (
+	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished; now you can run "qcollectiongenerator" with the ^
+.qhcp project file in %BUILDDIR%/qthelp, like this:
+	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\PlatformIO.qhcp
+	echo.To view the help file:
+	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\PlatformIO.ghc
+	goto end
+)
+
+if "%1" == "devhelp" (
+	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished.
+	goto end
+)
+
+if "%1" == "epub" (
+	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The epub file is in %BUILDDIR%/epub.
+	goto end
+)
+
+if "%1" == "latex" (
+	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
+	goto end
+)
+
+if "%1" == "latexpdf" (
+	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
+	cd %BUILDDIR%/latex
+	make all-pdf
+	cd %BUILDDIR%/..
+	echo.
+	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
+	goto end
+)
+
+if "%1" == "latexpdfja" (
+	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
+	cd %BUILDDIR%/latex
+	make all-pdf-ja
+	cd %BUILDDIR%/..
+	echo.
+	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
+	goto end
+)
+
+if "%1" == "text" (
+	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The text files are in %BUILDDIR%/text.
+	goto end
+)
+
+if "%1" == "man" (
+	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The manual pages are in %BUILDDIR%/man.
+	goto end
+)
+
+if "%1" == "texinfo" (
+	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
+	goto end
+)
+
+if "%1" == "gettext" (
+	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
+	goto end
+)
+
+if "%1" == "changes" (
+	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.The overview file is in %BUILDDIR%/changes.
+	goto end
+)
+
+if "%1" == "linkcheck" (
+	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Link check complete; look for any errors in the above output ^
+or in %BUILDDIR%/linkcheck/output.txt.
+	goto end
+)
+
+if "%1" == "doctest" (
+	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Testing of doctests in the sources finished, look at the ^
+results in %BUILDDIR%/doctest/output.txt.
+	goto end
+)
+
+if "%1" == "xml" (
+	%SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The XML files are in %BUILDDIR%/xml.
+	goto end
+)
+
+if "%1" == "pseudoxml" (
+	%SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.
+	goto end
+)
+
+:end

docs/platforms/atmelavr.rst

@@ -0,0 +1,359 @@
+.. _platform_atmelavr:
+
+Platform ``atmelavr``
+=====================
+
+`Atmel AVR® 8- and 32-bit MCUs <http://www.atmel.com/products/microcontrollers/avr/default.aspx>`_
+deliver a unique combination of performance, power efficiency and design
+flexibility. Optimized to speed time to market—and easily adapt to new
+ones—they are based on the industry's most code-efficient architecture for
+C and assembly programming.
+
+.. contents::
+
+Packages
+--------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Alias
+      - Contents
+    * - ``toolchain-atmelavr``
+      - toolchain
+      - `avr-gcc <https://gcc.gnu.org/wiki/avr-gcc>`_,
+        `GDB <http://www.gnu.org/software/gdb/>`_,
+        `AVaRICE <http://avarice.sourceforge.net>`_,
+        `SimulAVR <http://www.nongnu.org/simulavr/>`_
+    * - ``tool-avrdude``
+      - uploader
+      - `AVRDUDE <http://www.nongnu.org/avrdude/>`_
+    * - ``framework-arduinoavr``
+      - framework
+      - See below in :ref:`atmelavr_frameworks`
+
+
+.. note::
+    You can install ``atmelavr`` platform with these packages
+    via :ref:`cmd_install` command.
+
+
+.. _atmelavr_frameworks:
+
+Frameworks
+----------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``framework``
+      - Name
+      - Reference
+    * - ``arduino``
+      - Arduino Wiring-based Framework (AVR Core, 1.5.x branch)
+      - `Documentation <http://arduino.cc/en/Reference/HomePage>`_
+
+
+Boards
+------
+
+.. note::
+    * You can list pre-configured boards by :ref:`cmd_boards` command
+    * For more detailed ``board`` information please scroll tables below by
+      horizontal.
+
+Arduino
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller ``board_mcu``
+      - Frequency ``board_f_cpu``
+      - Flash
+      - RAM
+    * - ``diecimilaatmega168``
+      - `Arduino Diecimila or Duemilanove (ATmega168)
+        <http://arduino.cc/en/Main/ArduinoBoardDiecimila>`_
+      - ATmega168 ``atmega168``
+      - 16 MHz ``16000000L``
+      - 16 Kb
+      - 1 Kb
+    * - ``diecimilaatmega328``
+      - `Arduino Diecimila or Duemilanove (ATmega328)
+        <http://arduino.cc/en/Main/ArduinoBoardDiecimila>`_
+      - ATmega328 ``atmega328``
+      - 16 MHz ``16000000L``
+      - 32 Kb
+      - 2 Kb
+    * - ``fio``
+      - `Arduino Fio
+        <http://arduino.cc/en/Main/ArduinoBoardFio>`_
+      - ATmega328P ``atmega328p``
+      - 8 MHz ``8000000L``
+      - 32 Kb
+      - 2 Kb
+    * - ``leonardo``
+      - `Arduino Leonardo <http://arduino.cc/en/Main/arduinoBoardLeonardo>`_
+      - ATmega32u4 ``atmega32u4``
+      - 16 MHz ``16000000L``
+      - 32 Kb
+      - 2.5 Kb
+    * - ``LilyPadUSB``
+      - `Arduino LilyPad USB
+        <http://arduino.cc/en/Main/ArduinoBoardLilyPadUSB>`_
+      - ATmega32u4 ``atmega32u4``
+      - 8 MHz ``8000000L``
+      - 32 Kb
+      - 2.5 Kb
+    * - ``lilypadatmega168``
+      - `Arduino LilyPad (ATmega168)
+        <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
+      - ATmega168 ``atmega168``
+      - 8 MHz ``8000000L``
+      - 16 Kb
+      - 1 Kb
+    * - ``lilypadatmega328``
+      - `Arduino LilyPad (ATmega328)
+        <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
+      - ATmega328P ``atmega328p``
+      - 8 MHz ``8000000L``
+      - 32 Kb
+      - 2 Kb
+    * - ``megaatmega1280``
+      - `Arduino Mega (ATmega1280)
+        <http://arduino.cc/en/Main/arduinoBoardMega>`_
+      - ATmega1280 ``atmega1280``
+      - 16 MHz ``16000000L``
+      - 128 Kb
+      - 8 Kb
+    * - ``megaatmega2560``
+      - `Arduino Mega (ATmega2560)
+        <http://arduino.cc/en/Main/arduinoBoardMega2560>`_
+      - ATmega2560 ``atmega2560``
+      - 16 MHz ``16000000L``
+      - 256 Kb
+      - 8 Kb
+    * - ``megaADK``
+      - `Arduino Mega ADK
+        <http://arduino.cc/en/Main/ArduinoBoardMegaADK>`_
+      - ATmega2560 ``atmega2560``
+      - 16 MHz ``16000000L``
+      - 256 Kb
+      - 8 Kb
+    * - ``micro``
+      - `Arduino Micro
+        <http://arduino.cc/en/Main/ArduinoBoardMicro>`_
+      - ATmega32u4 ``atmega32u4``
+      - 16 MHz ``16000000L``
+      - 32 Kb
+      - 2.5 Kb
+    * - ``miniatmega168``
+      - `Arduino Mini (ATmega168)
+        <http://arduino.cc/en/Main/ArduinoBoardMini>`_
+      - ATmega168 ``atmega168``
+      - 16 MHz ``16000000L``
+      - 16 Kb
+      - 1 Kb
+    * - ``miniatmega328``
+      - `Arduino Mini (ATmega328P)
+        <http://arduino.cc/en/Main/ArduinoBoardMini>`_
+      - ATmega328P ``atmega328p``
+      - 16 MHz ``16000000L``
+      - 32 Kb
+      - 2 Kb
+    * - ``nanoatmega168``
+      - `Arduino Nano (ATmega168)
+        <http://arduino.cc/en/Main/ArduinoBoardNano>`_
+      - ATmega168 ``atmega168``
+      - 16 MHz ``16000000L``
+      - 16 Kb
+      - 1 Kb
+    * - ``nanoatmega328``
+      - `Arduino Nano (ATmega328P)
+        <http://arduino.cc/en/Main/ArduinoBoardNano>`_
+      - ATmega328P ``atmega328p``
+      - 16 MHz ``16000000L``
+      - 32 Kb
+      - 2 Kb
+    * - ``pro8MHzatmega168``
+      - `Arduino Pro or Pro Mini (ATmega168, 3.3V)
+        <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
+      - ATmega168 ``atmega168``
+      - 8 MHz ``8000000L``
+      - 16 Kb
+      - 1 Kb
+    * - ``pro16MHzatmega168``
+      - `Arduino Pro or Pro Mini (ATmega168, 5V)
+        <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
+      - ATmega168 ``atmega168``
+      - 16 MHz ``16000000L``
+      - 16 Kb
+      - 1 Kb
+    * - ``pro8MHzatmega328``
+      - `Arduino Pro or Pro Mini (ATmega328P, 3.3V)
+        <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
+      - ATmega328P ``atmega328p``
+      - 8 MHz ``8000000L``
+      - 32 Kb
+      - 2 Kb
+    * - ``pro16MHzatmega328``
+      - `Arduino Pro or Pro Mini (ATmega328P, 5V)
+        <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
+      - ATmega328P ``atmega328p``
+      - 16 MHz ``16000000L``
+      - 32 Kb
+      - 2 Kb
+    * - ``uno``
+      - `Arduino Uno
+        <http://arduino.cc/en/Main/ArduinoBoardUno>`_
+      - ATmega328P ``atmega328p``
+      - 16 MHz ``16000000L``
+      - 32 Kb
+      - 2 Kb
+
+More detailed information you can find here
+`Arduino boards <http://arduino.cc/en/Main/Products>`_.
+
+
+Engduino
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller ``board_mcu``
+      - Frequency ``board_f_cpu``
+      - Flash
+      - RAM
+    * - ``engduinov1``
+      - `Engduino 1 <http://www.engduino.org>`_
+      - ATmega32u4 ``atmega32u4``
+      - 8 MHz ``8000000L``
+      - 32 Kb
+      - 2.5 Kb
+    * - ``engduinov2``
+      - `Engduino 2 <http://www.engduino.org>`_
+      - ATmega32u4 ``atmega32u4``
+      - 8 MHz ``8000000L``
+      - 32 Kb
+      - 2.5 Kb
+    * - ``engduinov3``
+      - `Engduino 3 <http://www.engduino.org>`_
+      - ATmega32u4 ``atmega32u4``
+      - 8 MHz ``8000000L``
+      - 32 Kb
+      - 2.5 Kb
+
+More detailed information you can find here
+`Engduino Site <http://www.engduino.org>`_.
+
+
+Microduino
+~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller ``board_mcu``
+      - Frequency ``board_f_cpu``
+      - Flash
+      - RAM
+    * - ``168pa8m``
+      - `Microduino Core (ATmega168P, 3.3V)
+        <http://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
+      - ATmega168P ``atmega168p``
+      - 8 MHz ``8000000L``
+      - 16 Kb
+      - 1 Kb
+    * - ``168pa16m``
+      - `Microduino Core (ATmega168P, 5V)
+        <http://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
+      - ATmega168P ``atmega168p``
+      - 16 MHz ``16000000L``
+      - 16 Kb
+      - 1 Kb
+    * - ``328p8m``
+      - `Microduino Core (ATmega328P, 3.3V)
+        <http://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
+      - ATmega328P ``atmega328p``
+      - 8 MHz ``8000000L``
+      - 32 Kb
+      - 2 Kb
+    * - ``328p16m``
+      - `Microduino Core (ATmega328P, 5V)
+        <http://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
+      - ATmega328P ``atmega328p``
+      - 16 MHz ``16000000L``
+      - 32 Kb
+      - 2 Kb
+    * - ``644pa8m``
+      - `Microduino Core+ (ATmega644PA, 3.3V)
+        <http://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
+      - ATmega644PA ``atmega644p``
+      - 8 MHz ``8000000L``
+      - 64 Kb
+      - 4 Kb
+    * - ``644pa16m``
+      - `Microduino Core+ (ATmega644PA, 5V)
+        <http://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
+      - ATmega644PA ``atmega644p``
+      - 16 MHz ``16000000L``
+      - 64 Kb
+      - 4 Kb
+    * - ``1284p8m``
+      - `Microduino Core+ (Atmega1284P, 3.3V)
+        <http://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
+      - Atmega1284P ``atmega1284p``
+      - 8 MHz ``8000000L``
+      - 128 Kb
+      - 16 Kb
+    * - ``1284p16m``
+      - `Microduino Core+ (Atmega1284P, 5V)
+        <http://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
+      - Atmega1284P ``atmega1284p``
+      - 16 MHz ``16000000L``
+      - 128 Kb
+      - 16 Kb
+    * - ``32u416m``
+      - `Microduino-Core USB
+        <http://www.microduino.cc/wiki/index.php?title=Microduino-CoreUSB>`_
+      - ATmega32u4 ``atmega32u4``
+      - 16 MHz ``16000000L``
+      - 32 Kb
+      - 2.5 Kb
+
+
+More detailed information you can find here
+`Microduino boards <http://www.microduino.cc/wiki/index.php?title=Main_Page>`_.
+
+
+Raspduino
+~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller ``board_mcu``
+      - Frequency ``board_f_cpu``
+      - Flash
+      - RAM
+    * - ``raspduino``
+      - `Raspduino
+        <http://www.bitwizard.nl/wiki/index.php/Raspduino>`_
+      - ATmega328P ``atmega328p``
+      - 16 MHz ``16000000L``
+      - 32 Kb
+      - 2 Kb
+
+More detailed information you can find here
+`Wiki <http://www.bitwizard.nl/wiki/index.php/Raspduino>`_.

docs/platforms/index.rst

@@ -0,0 +1,19 @@
+.. _platforms:
+
+Platforms & Embedded Boards
+===========================
+
+*PlatformIO* has pre-built different development platforms for popular OS
+(*Mac OS X, Linux (+ARMv6) and Windows*). Each of them include compiler,
+debugger, uploader (for embedded) and many other useful tools.
+
+Also it has pre-configured settings for most popular **Embedded Platform
+Boards**. You have no need to specify in :ref:`projectconf` type or frequency of
+MCU, upload protocol or etc. Please use ``board`` option.
+
+.. toctree::
+    :maxdepth: 2
+
+    atmelavr
+    timsp430
+    titiva

docs/platforms/timsp430.rst

@@ -0,0 +1,120 @@
+.. _platform_timsp430:
+
+Platform ``timsp430``
+=====================
+
+`MSP430 microcontrollers (MCUs) from Texas Instruments (TI) <http://www.ti.com/lsds/ti/microcontrollers_16-bit_32-bit/msp/overview.page>`_
+are 16-bit, RISC-based, mixed-signal processors designed for ultra-low power.
+These MCUs offer the lowest power consumption and the perfect mix of integrated
+peripherals for thousands of applications.
+
+.. contents::
+
+Packages
+--------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Alias
+      - Contents
+    * - ``toolchain-timsp430``
+      - toolchain
+      - `msp-gcc <http://sourceforge.net/projects/mspgcc/>`_,
+        `GDB <http://www.gnu.org/software/gdb/>`_
+    * - ``tool-mspdebug``
+      - uploader
+      - `MSPDebug <http://mspdebug.sourceforge.net>`_
+    * - ``framework-energiamsp430``
+      - framework
+      - See below in :ref:`timsp430_frameworks`
+
+
+.. note::
+    You can install ``atmelavr`` platform with these packages
+    via :ref:`cmd_install` command.
+
+
+.. _timsp430_frameworks:
+
+Frameworks
+----------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``framework``
+      - Name
+      - Reference
+    * - ``energia``
+      - Energia Wiring-based Framework (MSP430 Core)
+      - `Documentation <http://energia.nu/reference/>`_
+
+
+Boards
+------
+
+.. note::
+    * You can list pre-configured boards by :ref:`cmd_boards` command
+    * For more detailed ``board`` information please scroll tables below by
+      horizontal.
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller ``board_mcu``
+      - Frequency ``board_f_cpu``
+      - Flash
+      - RAM
+    * - ``lpmsp430g2231``
+      - `MSP430G2231 LaunchPad <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
+      - MSP430G2231 ``msp430g2231``
+      - 16 MHz ``16000000L``
+      - 2 Kb
+      - 128 B
+    * - ``lpmsp430g2452``
+      - `MSP430G2452 LaunchPad <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
+      - MSP430G2452 ``msp430g2452``
+      - 16 MHz ``16000000L``
+      - 8 Kb
+      - 256 B
+    * - ``lpmsp430g2553``
+      - `MSP430G2553 LaunchPad <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
+      - MSP430G2553 ``msp430g2553``
+      - 16 MHz ``16000000L``
+      - 16 Kb
+      - 512 B
+    * - ``lpmsp430f5529``
+      - `MSP430F5529 LaunchPad (16 Mhz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
+      - MSP430F5529 ``msp430f5529``
+      - 16 MHz ``16000000L``
+      - 128 Kb
+      - 8 KB
+    * - ``lpmsp430f5529_25``
+      - `MSP430F5529 LaunchPad (25 Mhz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
+      - MSP430F5529 ``msp430f5529``
+      - 25 MHz ``25000000L``
+      - 128 Kb
+      - 8 KB
+    * - ``lpmsp430fr5739``
+      - `MSP430FR5739 Experimenter Board <http://www.ti.com/tool/msp-exp430fr5739>`_
+      - MSP430FR5739 ``msp430fr5739``
+      - 16 MHz ``16000000L``
+      - 16 Kb
+      - 1 KB
+    * - ``lpmsp430fr5969``
+      - `MSP430FR5969 LaunchPad <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430fr5969.html>`_
+      - MSP430FR5969 ``msp430fr5969``
+      - 16 MHz ``16000000L``
+      - 64 Kb
+      - 2 KB
+
+
+More detailed information you can find here
+`MSP430 LaunchPads <http://www.ti.com/ww/en/launchpad/launchpads-msp430.html>`_.
+
+
+

docs/platforms/titiva.rst

@@ -0,0 +1,94 @@
+.. _platform_titiva:
+
+Platform ``titiva``
+===================
+
+`Texas Instruments TM4C12x MCUs <http://www.ti.com/lsds/ti/microcontrollers_16-bit_32-bit/c2000_performance/control_automation/tm4c12x/overview.page>`_
+offer the industry’s most popular ARM®
+Cortex®-M4 core with scalable memory and package options, unparalleled
+connectivity peripherals, advanced application functions, industry-leading
+analog integration, and extensive software solutions.
+
+.. contents::
+
+Packages
+--------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Alias
+      - Contents
+    * - ``toolchain-gccarmnoneeabi``
+      - toolchain
+      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded/>`_,
+        `GDB <http://www.gnu.org/software/gdb/>`_
+    * - ``tool-lm4flash``
+      - uploader
+      - `Flash Programmer <http://www.ti.com/tool/lmflashprogrammer>`_
+    * - ``framework-energiativa``
+      - framework
+      - See below in :ref:`titiva_frameworks`
+
+.. note::
+    You can install ``titiva`` platform with these packages
+    via :ref:`cmd_install` command.
+
+
+.. _titiva_frameworks:
+
+Frameworks
+----------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``framework``
+      - Name
+      - Reference
+    * - ``energia``
+      - Energia Wiring-based Framework (LM4F Core)
+      - `Documentation <http://energia.nu/reference/>`_
+
+
+Boards
+------
+
+.. note::
+    * You can list pre-configured boards by :ref:`cmd_boards` command
+    * For more detailed ``board`` information please scroll tables below by
+      horizontal.
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller ``board_mcu``
+      - Frequency ``board_f_cpu``
+      - Flash
+      - RAM
+    * - ``lplm4f120h5qr``
+      - `Stellaris LM4F120 LaunchPad <http://www.ti.com/tool/ek-lm4f120xl>`_
+      - LM4F120H5QR ``cortex-m4``
+      - 80 MHz ``80000000L``
+      - 256 Kb
+      - 32 Kb
+    * - ``lptm4c1230c3pm``
+      - `Tiva C Series TM4C123G LaunchPad
+        <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c123gxl.html>`_
+      - TM4C123GH6PM ``cortex-m4``
+      - 80 MHz ``80000000L``
+      - 256 Kb
+      - 32 Kb
+    * - ``lptm4c1294ncpdt``
+      - `Tiva C Series TM4C1294 Connected LaunchPad
+        <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c1294xl.html>`_
+      - TM4C1294NCPDT ``cortex-m4``
+      - 120 Mhz ``120000000L``
+      - 1 Mb
+      - 256 Kb
+
+More detailed information you can find here
+`TIVA C Series LaunchPads <http://www.ti.com/ww/en/launchpad/launchpads-connected.html>`_.

docs/projectconf.rst

@@ -0,0 +1,367 @@
+.. _projectconf:
+
+Project Configuration File
+==========================
+
+The Project configuration file is named ``platformio.ini``. This is a
+`INI-style <http://en.wikipedia.org/wiki/INI_file>`_ file.
+
+``platformio.ini`` has sections (each denoted by a ``[header]``) and
+key / value pairs within the sections. A sign ``#`` at the beginning of the
+line indicates a comment. Comment lines are ignored.
+
+The sections and their allowable values are described below.
+
+.. contents::
+
+[platformio]
+------------
+
+A ``platformio`` section is used for overriding default configuration options
+
+Options
+~~~~~~~
+
+``home_dir``
+^^^^^^^^^^^^
+
+A ``$PIO_HOME_DIR`` is used to store platform tool chains, frameworks,
+external libraries, service data and etc.
+
+A default value is user's home directory: *Unix* - ``~/.platformio``,
+Windows - ``%HOMEPATH%\.platformio``.
+
+
+``lib_dir``
+^^^^^^^^^^^^
+
+This directory is used to store external libraries downloaded by
+:ref:`librarymanager`.
+
+A default value is ``$PIO_HOME_DIR/lib``.
+
+[env:NAME]
+----------
+
+A section with ``env:`` prefix is used to define virtual environment with
+specific options that will be processed with :ref:`cmd_run` command. You can
+define unlimited numbers of environments.
+
+Each environment must have unique ``NAME``. The valid chars for ``NAME`` are
+
+* letters ``a-z``
+* numbers ``0-9``
+* special char ``_`` (underscore)
+
+For example, ``[env:hello_world]``.
+
+Options
+~~~~~~~
+
+.. _projectconf_env_platform:
+
+``platform``
+^^^^^^^^^^^^
+
+:ref:`Platform <platforms>` type
+
+
+.. _projectconf_env_framework:
+
+``framework``
+^^^^^^^^^^^^^
+
+See ``framework`` type in *Frameworks* section of :ref:`platforms`
+
+
+.. _projectconf_env_board:
+
+``board``
+^^^^^^^^^
+
+*PlatformIO* has pre-configured settings for most popular boards. You don't
+need to specify ``board_mcu``, ``board_f_cpu``, ``upload_protocol`` or
+``upload_speed`` options. Just define a ``board`` type and *PlatformIO* will
+pre-fill options described above with appropriate values.
+
+You can find the ``board`` type in *Boards* section of each :ref:`platforms`.
+
+
+``board_mcu``
+^^^^^^^^^^^^^
+
+``board_mcu`` is a microcontroller(MCU) type that is used by compiler to
+recognize MCU architecture. The correct type of ``board_mcu`` depends on
+platform library. For example, the list of ``board_mcu`` for "megaAVR Devices"
+is described `here <http://www.nongnu.org/avr-libc/user-manual/>`_.
+
+The full list of ``board_mcu`` for popular embedded platforms you can find in
+*Boards* section of :ref:`platforms`. See "Microcontroller" column.
+
+
+``board_f_cpu``
+^^^^^^^^^^^^^^^
+
+An option ``board_f_cpu`` is used to define MCU frequency (Hertz, Clock). A
+format of this option is ``C-like long integer`` value with ``L`` suffix. The
+1 Hertz is equal to ``1L``, then 16 Mhz (Mega Hertz) is equal to ``16000000L``.
+
+The full list of ``board_f_cpu`` for popular embedded platforms you can find in
+*Boards* section of :ref:`platforms`. See "Frequency" column.
+
+
+``upload_port``
+^^^^^^^^^^^^^^^
+
+This option is used by "uploader" tool to send firmware to the board via
+``upload_port``. For example,
+
+* ``/dev/ttyUSB0`` - Unix-based OS
+* ``COM3`` - Windows OS
+
+If ``upload_port`` isn't specified, then *PlatformIO* will try to detect
+``upload_port`` automatically.
+
+To print all available serial ports use :ref:`cmd_serialports` command.
+
+
+``upload_protocol``
+^^^^^^^^^^^^^^^^^^^
+
+A protocol that "uploader" tool uses to talk to the board.
+
+
+``upload_speed``
+^^^^^^^^^^^^^^^^
+
+A connection speed (`baud rate <http://en.wikipedia.org/wiki/Baud>`_)
+which "uploader" tool uses when sending firmware to the board.
+
+
+``targets``
+^^^^^^^^^^^
+
+A list with targets which will be processed by :ref:`cmd_run` command by
+default. You can enter more then one target separated with "space".
+
+When no targets are defined, *PlatformIO* will build only sources by default.
+
+.. note::
+    This option is useful to enable "auto-uploading" after building operation
+    (``targets = upload``).
+
+
+.. _projectconf_build_flags:
+
+``build_flags``
+^^^^^^^^^^^^^^^
+
+These flags/options control preprocessing, compilation, assembly and linking
+processes:
+
+.. list-table::
+    :header-rows:  1
+
+    * - Format
+      - Scope
+      - Description
+    * - ``Wp,option``
+      - CPPFLAGS
+      - Bypass the compiler driver and pass *option* directly  through to the
+        preprocessor
+    * - ``-D name``
+      - CPPDEFINES
+      - Predefine *name* as a macro, with definition 1.
+    * - ``-D name=definition``
+      - CPPDEFINES
+      - The contents of *definition* are tokenized and processed as if they
+        appeared during translation phase three in a ``#define`` directive.
+    * - ``-U name``
+      - CPPDEFINES
+      - Cancel any previous definition of *name*, either built in or provided
+        with a ``-D`` option.
+    * - ``-Wall``
+      - CCFLAGS
+      - Turns on all optional warnings which are desirable for normal code.
+    * - ``-Werror``
+      - CCFLAGS
+      - Make all warnings into hard errors. Source code which triggers warnings will be rejected.
+    * - ``-w``
+      - CCFLAGS
+      - Suppress all warnings, including those which GNU CPP issues by default.
+    * - ``-include file``
+      - CCFLAGS
+      - Process *file* as if ``#include "file"`` appeared as the first line of
+        the primary source file.
+    * - ``-Wa,option``
+      - ASFLAGS, CCFLAGS
+      - Pass *option* as an option to the assembler. If *option* contains
+        commas, it is split into multiple options at the commas.
+    * - ``-llibrary``
+      - LIBS
+      - Search the *library* named library when linking
+    * - ``-Ldir``
+      - LIBPATH
+      - Add directory *dir* to the list of directories to be searched for
+        ``-l``.
+    * - ``-Idir``
+      - CPPPATH
+      - Add the directory *dir* to the list of directories to be searched
+        for header files.
+
+Example:
+
+.. code-block::   ini
+
+    [env:specific_defines]
+    build_flags = -O2 -Dfoo -Dbar=1
+
+    [env:specific_inclibs]
+    build_flags = -I/opt/include -L/opt/lib -lfoo
+
+
+For more detailed information about available flags/options go to:
+
+* `Options to Request or Suppress Warnings
+  <https://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html>`_
+* `Options for Debugging Your Program
+  <https://gcc.gnu.org/onlinedocs/gcc/Debugging-Options.html>`_
+* `Options That Control Optimization
+  <https://gcc.gnu.org/onlinedocs/gcc/Optimize-Options.html>`_
+* `Options Controlling the Preprocessor
+  <https://gcc.gnu.org/onlinedocs/gcc/Preprocessor-Options.html>`_
+* `Passing Options to the Assembler
+  <https://gcc.gnu.org/onlinedocs/gcc/Assembler-Options.html>`_
+* `Options for Linking <https://gcc.gnu.org/onlinedocs/gcc/Link-Options.html>`_
+* `Options for Directory Search
+  <https://gcc.gnu.org/onlinedocs/gcc/Directory-Options.html>`_
+
+
+``srcbuild_flags``
+^^^^^^^^^^^^^^^^^^
+
+This is option ``srcbuild_flags`` has the same behaviour like ``build_flags``
+but will be applied only for project source code from ``src`` directory.
+
+.. _projectconf_examples:
+
+Examples
+--------
+
+1. :ref:`platform_atmelavr`: Arduino UNO board with auto pre-configured
+   ``board_*`` and ``upload_*`` options (use only ``board`` option) and Arduino
+   Wiring-based Framework
+
+.. code-block:: ini
+
+    [env:atmelavr_arduino_uno_board]
+    platform = atmelavr
+    framework = arduino
+    board = uno
+
+    # enable auto-uploading
+    targets = upload
+
+
+2. :ref:`platform_atmelavr`: Microduino Core (ATmega168P, 3.3V) board with
+   auto pre-configured ``board_*`` and ``upload_*`` options (use only
+   ``board`` option) and Arduino Wiring-based Framework
+
+.. code-block:: ini
+
+    [env:atmelavr_microduino_core_board]
+    platform = atmelavr
+    framework = arduino
+    board = 168pa8m
+
+    # enable auto-uploading
+    targets = upload
+
+
+3. :ref:`platform_atmelavr`: Raspduino board with
+   auto pre-configured ``board_*`` and ``upload_*`` options (use only
+   ``board`` option) and Arduino Wiring-based Framework
+
+.. code-block:: ini
+
+    [env:atmelavr_raspduino_board]
+    platform = atmelavr
+    framework = arduino
+    board = raspduino
+
+    upload_port = /dev/ttyS0
+
+    # enable auto-uploading
+    targets = upload
+
+
+4. :ref:`platform_atmelavr`: Embedded board that is based on ATmega168 MCU with
+   "arduino" bootloader
+
+.. code-block:: ini
+
+    [env:atmelavr_atmega168_board]
+    platform = atmelavr
+    board_mcu = atmega168
+    board_f_cpu = 16000000L
+
+    upload_port = /dev/ttyUSB0
+    # for Windows OS
+    # upload_port = COM3
+    upload_protocol = arduino
+    upload_speed = 19200
+
+    # enable auto-uploading
+    targets = upload
+
+
+5. Upload firmware via USB programmer (USBasp) to :ref:`platform_atmelavr`
+   microcontrollers
+
+.. code-block:: ini
+
+    [env:atmelavr_usbasp]
+    platform = atmelavr
+    framework = arduino
+    board = pro8MHzatmega328
+    upload_protocol = usbasp -B5
+
+
+6. :ref:`platform_timsp430`: TI MSP430G2553 LaunchPad with auto pre-configured
+   ``board_*`` and ``upload_*`` options (use only ``board`` option) and Energia
+   Wiring-based Framework
+
+.. code-block:: ini
+
+    [env:timsp430_g2553_launchpad]
+    platform = timsp430
+    framework = energia
+    board = lpmsp430g2553
+
+
+7. :ref:`platform_timsp430`: Embedded board that is based on MSP430G2553 MCU
+
+.. code-block:: ini
+
+    [env:timsp430_g2553_board]
+    platform = timsp430
+    board_mcu = msp430g2553
+    board_f_cpu = 16000000L
+
+    upload_protocol = rf2500
+
+    # enable auto-uploading
+    targets = upload
+
+
+8. :ref:`platform_titiva`: TI Tiva C ARM Series TM4C123G LaunchPad with auto
+   pre-configured ``board_*`` and ``upload_*`` options (use only ``board``
+   option) and Energia Wiring-based Framework
+
+.. code-block:: ini
+
+    [env:titiva_tm4c1230c3pm_launchpad]
+    platform = titiva
+    framework = energia
+    board = lptm4c1230c3pm
+

docs/quickstart.rst

@@ -0,0 +1,56 @@
+.. _quickstart:
+
+Quickstart
+==========
+
+.. note::
+    Please read `Get Started <http://platformio.org/#!/get-started>`_
+    article from the official WebSite.
+
+1. :ref:`Install PlatformIO <installation>`.
+
+2. Find board ``type`` from :ref:`platforms` (you can choose multiple board
+   types).
+
+3. Initialize new PlatformIO based project with the pre-configured
+   environments for your boards:
+
+.. code-block:: bash
+
+    $ platformio init --board=TYPE1 --board=TYPE2
+
+    The current working directory *** will be used for the new project.
+    You can specify another project directory via
+    `platformio init -d %PATH_TO_THE_PROJECT_DIR%` command.
+
+    The next files/directories will be created in ***
+    `platformio.ini` - Project Configuration File
+    `src` - a source directory. Put your source code here
+    `lib` - a directory for the project specific libraries
+    Do you want to continue? [y/N]: y
+    Project has been successfully initialized!
+    Now you can process it with `platformio run` command.
+
+More detailed information about this command is here :ref:`cmd_init`.
+
+4. Process the project's environments.
+
+.. code-block:: bash
+
+    $ platformio run
+
+    # if you don't have specified `targets = upload` option for environment,
+    # then you can upload firmware manually with this command:
+    $ platformio run --target upload
+
+    # clean project
+    $ platformio run --target clean
+
+If you don't have installed required platforms, then *PlatformIO* will propose
+you to install them automatically.
+
+Further examples can be found in the ``examples/`` directory in the source
+distribution or `on the web <https://github.com/ivankravets/platformio/tree/develop/examples>`_.
+
+Also, for more detailed information as for commands please go to
+:ref:`userguide` sections.

docs/userguide/cmd_boards.rst

@@ -0,0 +1,86 @@
+.. _cmd_boards:
+
+platformio boards
+=================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    # Print all available pre-configured embedded boards
+    platformio boards
+
+    # Filter boards by "Query"
+    platformio boards QUERY
+
+
+Description
+-----------
+
+List pre-configured Embedded Boards
+
+
+Examples
+--------
+
+1. Show Arduino-based boards
+
+.. code-block:: bash
+
+    $ platformio boards arduino
+
+    Platform: atmelavr
+    ---------------------------------------------------------------------------
+    Type                  MCU           Frequency  Flash   RAM    Name
+    ---------------------------------------------------------------------------
+    btatmega168           atmega168     16Mhz     14Kb    1Kb    Arduino BT ATmega168
+    btatmega328           atmega328p    16Mhz     28Kb    2Kb    Arduino BT ATmega328
+    diecimilaatmega168    atmega168     16Mhz     14Kb    1Kb    Arduino Duemilanove or Diecimila ATmega168
+    diecimilaatmega328    atmega328p    16Mhz     30Kb    2Kb    Arduino Duemilanove or Diecimila ATmega328
+    esplora               atmega32u4    16Mhz     28Kb    2Kb    Arduino Esplora
+    ethernet              atmega328p    16Mhz     31Kb    2Kb    Arduino Ethernet
+    ...
+
+
+2. Show boards which are based on ``ATmega168`` MCU
+
+.. code-block:: bash
+
+    $ platformio boards atmega168
+
+    Platform: atmelavr
+    ---------------------------------------------------------------------------
+    Type                  MCU           Frequency  Flash   RAM    Name
+    ---------------------------------------------------------------------------
+    btatmega168           atmega168     16Mhz     14Kb    1Kb    Arduino BT ATmega168
+    diecimilaatmega168    atmega168     16Mhz     14Kb    1Kb    Arduino Duemilanove or Diecimila ATmega168
+    miniatmega168         atmega168     16Mhz     14Kb    1Kb    Arduino Mini ATmega168
+    atmegangatmega168     atmega168     16Mhz     14Kb    1Kb    Arduino NG or older ATmega168
+    nanoatmega168         atmega168     16Mhz     14Kb    1Kb    Arduino Nano ATmega168
+    pro8MHzatmega168      atmega168     8Mhz      14Kb    1Kb    Arduino Pro or Pro Mini ATmega168 (3.3V, 8 MHz)
+    pro16MHzatmega168     atmega168     16Mhz     14Kb    1Kb    Arduino Pro or Pro Mini ATmega168 (5V, 16 MHz)
+    lilypadatmega168      atmega168     8Mhz      14Kb    1Kb    LilyPad Arduino ATmega168
+    168pa16m              atmega168p    16Mhz     15Kb    1Kb    Microduino Core (Atmega168PA@16M,5V)
+    168pa8m               atmega168p    8Mhz      15Kb    1Kb    Microduino Core (Atmega168PA@8M,3.3V)
+
+3. Show boards by :ref:`platform_timsp430`
+
+.. code-block:: bash
+
+    $ platformio boards timsp430
+
+    Platform: timsp430
+    ---------------------------------------------------------------------------
+    Type                  MCU           Frequency  Flash   RAM    Name
+    ---------------------------------------------------------------------------
+    lpmsp430fr5739        msp430fr5739  16Mhz     15Kb    1Kb    FraunchPad w/ msp430fr5739
+    lpmsp430f5529         msp430f5529   16Mhz     128Kb   1Kb    LaunchPad w/ msp430f5529 (16MHz)
+    lpmsp430f5529_25      msp430f5529   25Mhz     128Kb   1Kb    LaunchPad w/ msp430f5529 (25MHz)
+    lpmsp430fr5969        msp430fr5969  8Mhz      64Kb    1Kb    LaunchPad w/ msp430fr5969
+    lpmsp430g2231         msp430g2231   1Mhz      2Kb     128B   LaunchPad w/ msp430g2231 (1MHz)
+    lpmsp430g2452         msp430g2452   16Mhz     8Kb     256B   LaunchPad w/ msp430g2452 (16MHz)
+    lpmsp430g2553         msp430g2553   16Mhz     16Kb    512B   LaunchPad w/ msp430g2553 (16MHz)
+

docs/userguide/cmd_init.rst

@@ -0,0 +1,105 @@
+.. _cmd_init:
+
+platformio init
+===============
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio init [OPTIONS]
+
+
+Description
+-----------
+
+Initialize new PlatformIO based project.
+
+
+This command will create:
+
+* :ref:`projectconf`
+* ``src`` - a source directory. Put your source code here
+* ``lib`` - a directory for the project specific libraries. PlatformIO will
+  compile them to static libraries and link to executable file
+
+Options
+-------
+
+.. option::
+    --project-dir, -d
+
+A path to the directory where *PlatformIO* will initialise new project.
+
+.. option::
+    --board, -b
+
+If you specify board ``type`` (you can pass multiple ``--board`` options), then
+*PlatformIO* will automatically generate environment for :ref:`projectconf` and
+pre-fill these data:
+
+* :ref:`projectconf_env_platform`
+* :ref:`projectconf_env_framework`
+* :ref:`projectconf_env_board`
+
+The full list with pre-configured boards is available here :ref:`platforms`.
+
+.. option::
+    --disable-auto-uploading
+
+If you initialise project with the specified ``--board``, then *PlatformIO*
+will create environment with enabled firmware auto-uploading. This option
+allows you to disable firmware auto-uploading by default.
+
+Examples
+--------
+
+1. Create new project in the current working directory
+
+.. code-block:: bash
+
+    $ platformio init
+
+    The current working directory *** will be used for the new project.
+    You can specify another project directory via
+    `platformio init -d %PATH_TO_THE_PROJECT_DIR%` command.
+
+    The next files/directories will be created in ***
+    platformio.ini - Project Configuration File
+    src - a source directory. Put your source code here
+    lib - a directory for the project specific libraries
+    Do you want to continue? [y/N]: y
+    Project has been successfully initialized!
+    Now you can process it with `platformio run` command.
+
+
+2. Create new project in the specified directory
+
+.. code-block:: bash
+
+    $ platformio init -d %PATH_TO_DIR%
+
+    The next files/directories will be created in ***
+    platformio.ini - Project Configuration File
+    src - a source directory. Put your source code here
+    lib - a directory for the project specific libraries
+    Do you want to continue? [y/N]: y
+    Project has been successfully initialized!
+    Now you can process it with `platformio run` command.
+
+3. Initialise project for Arduino Uno
+
+.. code-block:: bash
+
+    $ platformio init --board uno
+
+    The next files/directories will be created in ***
+    platformio.ini - Project Configuration File
+    src - a source directory. Put your source code here
+    lib - a directory for the project specific libraries
+    Do you want to continue? [y/N]: y
+    Project has been successfully initialized!
+    Now you can process it with `platformio run` command.

docs/userguide/cmd_install.rst

@@ -0,0 +1,76 @@
+.. _cmd_install:
+
+platformio install
+==================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio install [OPTIONS] [PLATFORMS]
+
+
+Description
+-----------
+
+Install pre-built development :ref:`Platforms <platforms>` with related
+packages.
+
+There are several predefined aliases for packages, such as:
+
+* ``toolchain``
+* ``uploader``
+* ``framework``
+
+Options
+-------
+
+.. option::
+    --with-package
+
+Install specified package (or alias)
+
+
+.. option::
+    --without-package
+
+Do not install specified package (or alias)
+
+.. option::
+    --skip-default
+
+Skip default packages
+
+Examples
+--------
+
+1. Install :ref:`platform_timsp430` with default packages
+
+.. code-block:: bash
+
+    $ platformio install timsp430
+    Installing toolchain-timsp430 package:
+    Downloading  [####################################]  100%
+    Unpacking  [####################################]  100%
+    Installing tool-mspdebug package:
+    Downloading  [####################################]  100%
+    Unpacking  [####################################]  100%
+    Installing framework-energiamsp430 package:
+    Downloading  [####################################]  100%
+    Unpacking  [####################################]  100%
+    The platform 'timsp430' has been successfully installed!
+
+
+2. Install :ref:`platform_timsp430` with ``uploader`` utility only and skip
+   default packages
+
+.. code-block:: bash
+
+    $ platformio install timsp430 --skip-default-package --with-package=uploader
+    Installing tool-mspdebug package:
+    Downloading  [####################################]  100%
+    Unpacking  [####################################]  100%
+    The platform 'timsp430' has been successfully installed!

docs/userguide/cmd_list.rst

@@ -0,0 +1,30 @@
+.. _cmd_list:
+
+platformio list
+===============
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio list
+
+
+Description
+-----------
+
+List installed :ref:`Platforms <platforms>`
+
+
+Examples
+--------
+
+.. code-block:: bash
+
+    $ platformio list
+    timsp430    with packages: toolchain-timsp430, tool-mspdebug, framework-energiamsp430
+    atmelavr    with packages: toolchain-atmelavr, tool-avrdude, framework-arduinoavr
+    titiva      with packages: toolchain-gccarmnoneeabi, tool-lm4flash, framework-energiativa

docs/userguide/cmd_run.rst

@@ -0,0 +1,130 @@
+.. _cmd_run:
+
+platformio run
+==============
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio run [OPTIONS]
+
+
+Description
+-----------
+
+Process environments which are defined in :ref:`projectconf` file
+
+
+Options
+-------
+
+.. option::
+    -e, --environment
+
+Process specified environments
+
+
+.. option::
+    -t, --target
+
+Process specified targets
+
+.. option::
+    --upload-port
+
+Upload port of embedded board. To print all available ports use
+:ref:`cmd_serialports` command
+
+Examples
+--------
+
+1. Process `Wiring Blink Example <https://github.com/ivankravets/platformio/tree/develop/examples/wiring-blink>`_
+
+.. code-block::   bash
+
+    $ platformio run
+    Processing arduino_pro5v environment:
+    scons: `.pioenvs/arduino_pro5v/firmware.elf' is up to date.
+    scons: `.pioenvs/arduino_pro5v/firmware.hex' is up to date.
+
+    Processing launchpad_msp430g2 environment:
+    scons: `.pioenvs/launchpad_msp430g2/firmware.elf' is up to date.
+    scons: `.pioenvs/launchpad_msp430g2/firmware.hex' is up to date.
+
+    Processing launchpad_lm4f120 environment:
+    scons: `.pioenvs/launchpad_lm4f120/firmware.elf' is up to date.
+    scons: `.pioenvs/launchpad_lm4f120/firmware.hex' is up to   date
+
+
+2. Process specific environment
+
+.. code-block:: bash
+
+    $ platformio run -e arduino_pro5v -e launchpad_lm4f120
+    Processing arduino_pro5v environment:
+    scons: `.pioenvs/arduino_pro5v/firmware.elf' is up to date.
+    scons: `.pioenvs/arduino_pro5v/firmware.hex' is up to date.
+
+    Processing launchpad_lm4f120 environment:
+    scons: `.pioenvs/launchpad_lm4f120/firmware.elf' is up to date.
+    scons: `.pioenvs/launchpad_lm4f120/firmware.hex' is up to date.
+
+
+3. Process specific target
+
+.. code-block:: bash
+
+    $ platformio run -t clean
+    Processing arduino_pro5v environment:
+    Removed .pioenvs/arduino_pro5v/src/main.o
+    ...
+    Removed .pioenvs/arduino_pro5v/firmware.hex
+
+    Processing launchpad_msp430g2 environment:
+    Removed .pioenvs/launchpad_msp430g2/src/main.o
+    ...
+    Removed .pioenvs/launchpad_msp430g2/firmware.hex
+
+    Processing launchpad_lm4f120 environment:
+    Removed .pioenvs/launchpad_lm4f120/src/main.o
+    ...
+    Removed .pioenvs/launchpad_lm4f120/firmware.hex
+
+
+4. Mix environments and targets
+
+.. code-block:: bash
+
+    $ platformio run -e launchpad_msp430g2 -t upload
+    Processing launchpad_msp430g2 environment:
+    /Users/ikravets/.platformio/timsp430/tools/mspdebug/mspdebug rf2500 --force-reset "prog .pioenvs/launchpad_msp430g2/firmware.hex"
+    MSPDebug version 0.20 - debugging tool for MSP430 MCUs
+    Copyright (C) 2009-2012 Daniel Beer <dlbeer@gmail.com>
+    This is free software; see the source for copying conditions.  There is NO
+    warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+    Trying to open interface 1 on 009
+    Initializing FET...
+    FET protocol version is 30394216
+    Configured for Spy-Bi-Wire
+    Sending reset...
+    Set Vcc: 3000 mV
+    Device ID: 0x2553
+      Code start address: 0xc000
+      Code size         : 16384 byte = 16 kb
+      RAM  start address: 0x200
+      RAM  end   address: 0x3ff
+      RAM  size         : 512 byte = 0 kb
+    Device: MSP430G2553/G2403
+    Code memory starts at 0xc000
+    Number of breakpoints: 2
+    Chip ID data: 25 53
+    Erasing...
+    Programming...
+    Writing  646 bytes at c000...
+    Writing   32 bytes at ffe0...
+    Done, 678 bytes total

docs/userguide/cmd_search.rst

@@ -0,0 +1,42 @@
+.. _cmd_search:
+
+platformio search
+=================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    # Print all available development platforms
+    platformio search
+
+    # Filter platforms by "Query"
+    platformio search QUERY
+
+
+Description
+-----------
+
+Search for development :ref:`Platforms <platforms>`
+
+
+Examples
+--------
+
+1. Search for TI development platforms
+
+.. code-block:: bash
+
+    $ platformio search ti
+    timsp430 - An embedded platform for TI MSP430 microcontrollers (with Energia Framework)
+    titiva   - An embedded platform for TI TIVA C ARM microcontrollers (with Energia Framework)
+
+2. Search for development platforms which support "Arduino Framework"
+
+.. code-block:: bash
+
+    $ platformio search arduino
+    atmelavr - An embedded platform for Atmel AVR microcontrollers (with Arduino Framework)

docs/userguide/cmd_serialports.rst

@@ -0,0 +1,243 @@
+.. _cmd_serialports:
+
+platformio serialports
+======================
+
+.. contents::
+
+platformio serialports list
+---------------------------
+
+Usage
+~~~~~
+
+.. code-block:: bash
+
+    platformio serialports list
+
+
+Description
+~~~~~~~~~~~
+
+List available `Serial Ports <http://en.wikipedia.org/wiki/Serial_port>`_
+
+
+Examples
+~~~~~~~~
+
+1. Unix OS
+
+.. code-block:: bash
+
+    $ platformio serialports list
+    /dev/cu.SLAB_USBtoUART
+    ----------
+    Hardware ID: USB VID:PID=10c4:ea60 SNR=0001
+    Description: CP2102 USB to UART Bridge Controller
+
+    /dev/cu.uart-1CFF4676258F4543
+    ----------
+    Hardware ID: USB VID:PID=451:f432 SNR=1CFF4676258F4543
+    Description: Texas Instruments MSP-FET430UIF
+
+
+2. Windows OS
+
+.. code-block:: bash
+
+    $ platformio serialports list
+    COM4
+    ----------
+    Hardware ID: USB VID:PID=0451:F432
+    Description: MSP430 Application UART (COM4)
+
+    COM3
+    ----------
+    Hardware ID: USB VID:PID=10C4:EA60 SNR=0001
+    Description: Silicon Labs CP210x USB to UART Bridge (COM3)
+
+
+platformio serialports monitor
+------------------------------
+
+Usage
+~~~~~
+
+.. code-block:: bash
+
+    platformio serialports monitor [OPTIONS]
+
+
+Description
+~~~~~~~~~~~
+
+This is a console application that provides a small terminal
+application. It is based on `Miniterm <http://pyserial.sourceforge.net/examples.html#miniterm>`_
+and itself does not implement any terminal features such
+as *VT102* compatibility. However it inherits these features from the terminal
+it is run. For example on GNU/Linux running from an *xterm* it will support the
+escape sequences of the *xterm*. On *Windows* the typical console window is dumb
+and does not support any escapes. When *ANSI.sys* is loaded it supports some
+escapes.
+
+To control *monitor* please use these "hot keys":
+
+* ``Ctrl+]`` Quit
+* ``Ctrl+T`` Menu
+* ``Ctrl+T followed by Ctrl+H`` Help
+
+Options
+~~~~~~~
+
+.. option::
+    -p, --port
+
+Port, a number or a device name
+
+.. option::
+    -b, --baud
+
+Set baud rate, default ``9600``
+
+.. option::
+    --parity
+
+Set parity (*None, Even, Odd, Space, Mark*), one of
+[``N``, ``E``, ``O``, ``S``, ``M``], default ``N``
+
+.. option::
+    --rtscts
+
+Enable ``RTS/CTS`` flow control, default ``Off``
+
+.. option::
+    --xonxoff
+
+Enable software flow control, default ``Off``
+
+.. option::
+    --rts
+
+Set initial ``RTS`` line state, default ``0``
+
+.. option::
+    --dtr
+
+Set initial ``DTR`` line state, default ``0``
+
+.. option::
+    --echo
+
+Enable local echo, default ``Off``
+
+.. option::
+    --cr
+
+Do not send ``CR+LF``, send ``R`` only, default ``Off``
+
+.. option::
+    --lf
+
+Do not send ``CR+LF``, send ``LF`` only, default ``Off``
+
+.. option::
+    -d, --debug
+
+Debug received data (escape non-printable chars). ``--debug`` can be given
+multiple times:
+
+0. just print what is received
+1. escape non-printable characters, do newlines as unusual
+2. escape non-printable characters, newlines too
+3. hex dump everything
+
+.. option::
+    --exit-char
+
+ASCII code of special character that is used to exit the application,
+default ``0x1d``
+
+.. option::
+    --menu-char
+
+ASCII code of special character that is used to control miniterm (menu),
+default ``0x14``
+
+.. option::
+    ---quiet
+
+Diagnostics: suppress non-error messages, default ``Off``
+
+Examples
+~~~~~~~~
+
+1. Show available options for *monitor*
+
+.. code-block:: bash
+
+    $ platformio serialports monitor --help
+    Usage: platformio serialports monitor [OPTIONS]
+
+    Options:
+      -p, --port TEXT       Port, a number or a device name
+      -b, --baud INTEGER    Set baud rate, default=9600
+      --parity [N|E|O|S|M]  Set parity, default=N
+      --rtscts              Enable RTS/CTS flow control, default=Off
+      --xonxoff             Enable software flow control, default=Off
+      --rts [0|1]           Set initial RTS line state, default=0
+      --dtr [0|1]           Set initial DTR line state, default=0
+      --echo                Enable local echo, default=Off
+      --cr                  Do not send CR+LF, send CR only, default=Off
+      --lf                  Do not send CR+LF, send LF only, default=Off
+      -d, --debug           Debug received data (escape non-printable chars)
+                            --debug can be given multiple times:
+                            0: just print what is received
+                            1: escape non-printable characters, do newlines as
+                               unusual
+                            2: escape non-printable characters, newlines too
+                            3: hex dump everything
+      --exit-char INTEGER   ASCII code of special character that is used to exit
+                            the application, default=0x1d
+      --menu-char INTEGER   ASCII code of special character that is used to
+                            control miniterm (menu), default=0x14
+      --quiet               Diagnostics: suppress non-error messages, default=Off
+      --help                Show this message and exit.
+
+2. Communicate with serial device and print help inside terminal
+
+.. code-block:: bash
+
+    $ platformio serialports monitor
+
+    --- Available ports:
+    --- /dev/cu.Bluetooth-Incoming-Port n/a
+    --- /dev/cu.Bluetooth-Modem n/a
+    --- /dev/cu.SLAB_USBtoUART CP2102 USB to UART Bridge Controller
+    --- /dev/cu.obd2ecu-SPPDev n/a
+    Enter port name:/dev/cu.SLAB_USBtoUART
+    --- Miniterm on /dev/cu.SLAB_USBtoUART: 9600,8,N,1 ---
+    --- Quit: Ctrl+]  |  Menu: Ctrl+T | Help: Ctrl+T followed by Ctrl+H ---
+    Hello PlatformIO!
+    --- pySerial (2.7) - miniterm - help
+    ---
+    --- Ctrl+]   Exit program
+    --- Ctrl+T   Menu escape key, followed by:
+    --- Menu keys:
+    ---    Ctrl+T  Send the menu character itself to remote
+    ---    Ctrl+]  Send the exit character itself to remote
+    ---    Ctrl+I  Show info
+    ---    Ctrl+U  Upload file (prompt will be shown)
+    --- Toggles:
+    ---    Ctrl+R  RTS          Ctrl+E  local echo
+    ---    Ctrl+D  DTR          Ctrl+B  BREAK
+    ---    Ctrl+L  line feed    Ctrl+A  Cycle repr mode
+    ---
+    --- Port settings (Ctrl+T followed by the following):
+    ---    p          change port
+    ---    7 8        set data bits
+    ---    n e o s m  change parity (None, Even, Odd, Space, Mark)
+    ---    1 2 3      set stop bits (1, 2, 1.5)
+    ---    b          change baud rate
+    ---    x X        disable/enable software flow control
+    ---    r R        disable/enable hardware flow control
+    --- exit ---

docs/userguide/cmd_settings.rst

@@ -0,0 +1,114 @@
+.. _cmd_settings:
+
+platformio settings
+===================
+
+Manage PlatformIO settings
+
+.. contents::
+
+platformio settings get
+-----------------------
+
+Usage
+~~~~~
+
+.. code-block:: bash
+
+    platformio settings get [NAME]
+
+
+Description
+~~~~~~~~~~~
+
+Get/List existing settings
+
+
+Examples
+~~~~~~~~
+
+1. List all settings and current their values
+
+.. code-block:: bash
+
+    $ platformio settings get
+    Name                            Value [Default]   Description
+    ------------------------------------------------------------------------------------------
+    auto_update_libraries           Yes               Automatically update libraries (Yes/No)
+    auto_update_platforms           Yes               Automatically update platforms (Yes/No)
+    check_libraries_interval        7                 Check for the library updates interval (days)
+    check_platformio_interval       3                 Check for the new PlatformIO interval (days)
+    check_platforms_interval        7                 Check for the platforms updates interval (days)
+
+
+2. Show specified setting
+
+.. code-block:: bash
+
+    $ platformio settings get auto_update_platforms
+    Name                            Value [Default]   Description
+    ------------------------------------------------------------------------------------------
+    auto_update_platforms           Yes               Automatically update platforms (Yes/No)
+
+
+platformio settings set
+-----------------------
+
+Usage
+~~~~~
+
+.. code-block:: bash
+
+    platformio settings set NAME VALUE
+
+
+Description
+~~~~~~~~~~~
+
+Set new value for the setting
+
+Examples
+~~~~~~~~
+
+Change to check for the new PlatformIO each day
+
+.. code-block:: bash
+
+    $ platformio settings set check_platformio_interval 1
+    The new value for the setting has been set!
+    Name                            Value [Default]   Description
+    ------------------------------------------------------------------------------------------
+    check_platformio_interval       1 [3]             Check for the new PlatformIO interval (days)
+
+
+platformio settings reset
+-------------------------
+
+Usage
+~~~~~
+
+.. code-block:: bash
+
+    platformio settings reset
+
+
+Description
+~~~~~~~~~~~
+
+Reset settings to default
+
+Examples
+~~~~~~~~
+
+.. code-block:: bash
+
+    $ platformio settings reset
+    The settings have been reseted!
+
+    Name                            Value [Default]   Description
+    ------------------------------------------------------------------------------------------
+    auto_update_libraries           Yes               Automatically update libraries (Yes/No)
+    auto_update_platforms           Yes               Automatically update platforms (Yes/No)
+    check_libraries_interval        7                 Check for the library updates interval (days)
+    check_platformio_interval       3                 Check for the new PlatformIO interval (days)
+    check_platforms_interval        7                 Check for the platform updates interval (days)

docs/userguide/cmd_show.rst

@@ -0,0 +1,42 @@
+.. _cmd_show:
+
+platformio show
+===============
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio show PLATFORM
+
+
+Description
+-----------
+
+Show details about the installed :ref:`Platforms <platforms>`
+
+
+Examples
+--------
+
+.. code-block:: bash
+
+    $ platformio show atmelavr
+    atmelavr    - An embedded platform for Atmel AVR microcontrollers (with Arduino Framework)
+    ----------
+    Package: toolchain-atmelavr
+    Alias: toolchain
+    Location: /Users/ikravets/.platformio/atmelavr/tools/toolchain
+    Version: 1
+    ----------
+    Package: tool-avrdude
+    Alias: uploader
+    Location: /Users/ikravets/.platformio/atmelavr/tools/avrdude
+    Version: 1
+    ----------
+    Package: framework-arduinoavr
+    Location: /Users/ikravets/.platformio/atmelavr/frameworks/arduino
+    Version: 1

docs/userguide/cmd_uninstall.rst

@@ -0,0 +1,31 @@
+.. _cmd_uninstall:
+
+platformio uninstall
+====================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio uninstall PLATFORM
+
+
+Description
+-----------
+
+Uninstall specified :ref:`Platforms <platforms>`
+
+
+Examples
+--------
+
+.. code-block:: bash
+
+    $ platformio uninstall timsp430
+    Uninstalling toolchain-timsp430 package:        [OK]
+    Uninstalling tool-mspdebug package:             [OK]
+    Uninstalling framework-energiamsp430 package:   [OK]
+    The platform 'timsp430' has been successfully uninstalled!

docs/userguide/cmd_update.rst

@@ -0,0 +1,54 @@
+.. _cmd_update:
+
+platformio update
+=================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio update
+
+
+Description
+-----------
+
+Check or update installed :ref:`Platforms <platforms>`
+
+
+Examples
+--------
+
+.. code-block:: bash
+
+    $ platformio update
+
+    Platform atmelavr
+    --------
+    Updating toolchain-atmelavr package:
+    Versions: Current=1, Latest=1 	 [Up-to-date]
+    Updating framework-arduinoavr package:
+    Versions: Current=1, Latest=1 	 [Up-to-date]
+    Updating tool-avrdude package:
+    Versions: Current=1, Latest=1 	 [Up-to-date]
+
+    Platform timsp430
+    --------
+    Updating toolchain-timsp430 package:
+    Versions: Current=1, Latest=1 	 [Up-to-date]
+    Updating tool-mspdebug package:
+    Versions: Current=1, Latest=1 	 [Up-to-date]
+    Updating framework-energiamsp430 package:
+    Versions: Current=1, Latest=1 	 [Up-to-date]
+
+    Platform titiva
+    --------
+    Updating toolchain-gccarmnoneeabi package:
+    Versions: Current=1, Latest=1 	 [Up-to-date]
+    Updating tool-lm4flash package:
+    Versions: Current=1, Latest=1 	 [Up-to-date]
+    Updating framework-energiativa package:
+    Versions: Current=1, Latest=1 	 [Up-to-date]

docs/userguide/cmd_upgrade.rst

@@ -0,0 +1,32 @@
+.. _cmd_upgrade:
+
+platformio upgrade
+==================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio upgrade
+
+
+Description
+-----------
+
+Check or upgrade PlatformIO to the latest version
+
+
+Examples
+--------
+
+.. code-block:: bash
+
+    $ platformio upgrade
+    You're up-to-date!
+    PlatformIO x.x.x is currently the newest version available.
+
+    # If you have problem with permissions try:
+    $ sudo platformio upgrade

docs/userguide/index.rst

@@ -0,0 +1,29 @@
+.. _userguide:
+
+User Guide
+==========
+
+To print all available commands and options use:
+
+.. code-block:: bash
+
+    $ platformio --help
+    $ platformio COMMAND --help
+
+
+.. toctree::
+    :maxdepth: 2
+
+    cmd_boards
+    cmd_init
+    cmd_install
+    platformio lib <lib/index>
+    cmd_list
+    cmd_run
+    cmd_search
+    cmd_serialports
+    cmd_settings
+    cmd_show
+    cmd_uninstall
+    cmd_update
+    cmd_upgrade

docs/userguide/lib/cmd_install.rst

@@ -0,0 +1,72 @@
+.. _cmd_lib_install:
+
+platformio lib install
+======================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio lib install [OPTIONS] [LIBRARY_ID]
+
+
+Description
+-----------
+
+Install new library  by specified
+`PlatformIO Library Registry ID <http://platformio.org/#!/lib>`_.
+
+Options
+-------
+
+.. option::
+    -v, --version
+
+Install specified version of library
+
+
+Examples
+--------
+
+1. Install the latest version of library
+
+.. code-block:: bash
+
+    # IRremote: http://platformio.org/#!/lib/show/4/IRremote
+    $ platformio lib install 4
+    # Installing library [ 4 ]:
+    # Downloading  [####################################]  100%
+    # Unpacking  [####################################]  100%
+    # The library #4 'IRremote' has been successfully installed!
+
+
+2. Install specified version of library
+
+.. code-block:: bash
+
+    # XBee: http://platformio.org/#!/lib/show/6/XBee
+    $ platformio lib install 6 --version=0.5
+    # Installing library [ 6 ]:
+    # Downloading  [####################################]  100%
+    # Unpacking  [####################################]  100%
+    # The library #6 'XBee' has been successfully installed!
+
+
+3. Install library with dependencies
+
+.. code-block:: bash
+
+    # Adafruit-ST7735: http://platformio.org/#!/lib/show/12/Adafruit-ST7735
+    $ platformio lib install 12
+    # Installing library [ 12 ]:
+    # Downloading  [####################################]  100%
+    # Unpacking  [####################################]  100%
+    # The library #12 'Adafruit-ST7735' has been successfully installed!
+    # Installing dependencies:
+    # Installing library [ 13 ]:
+    # Downloading  [####################################]  100%
+    # Unpacking  [####################################]  100%
+    # The library #13 'Adafruit-GFX' has been successfully installed!

docs/userguide/lib/cmd_list.rst

@@ -0,0 +1,39 @@
+.. _cmd_lib_list:
+
+platformio lib list
+===================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio lib list
+
+
+Description
+-----------
+
+List installed libraries
+
+
+Examples
+--------
+
+.. code-block:: bash
+
+    $ platformio lib list
+    #
+    # [ ID  ] Name             Compatibility         "Authors": Description
+    # -------------------------------------------------------------------------------------
+    # [ 23  ] Adafruit-L3GD20-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for the L3GD20 Gyroscope
+    # [ 12  ] Adafruit-ST7735  arduino, atmelavr     "Adafruit Industries": A library for the Adafruit 1.8" SPI display
+    # [ 31  ] Adafruit-Unified-Sensor arduino, atmelavr     "Adafruit Industries": Adafruit Unified Sensor Driver
+    # [ 26  ] Adafruit-LSM303DLHC-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for Adafruit's LSM303 Breakout (Accelerometer + Magnetometer)
+    # [  6  ] XBee             arduino, atmelavr     "Andrew Rapp": Arduino library for communicating with XBees in API mode
+    # [ 13  ] Adafruit-GFX     arduino, atmelavr     "Adafruit Industries": A core graphics library for all our displays, providing a common set of graphics primitives (points, lines, circles, etc.)
+    # [  4  ] IRremote         arduino, atmelavr     "Ken Shirriff": Send and receive infrared signals with multiple protocols
+    # [ 14  ] Adafruit-9DOF-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for the Adafruit 9DOF Breakout (L3GD20 / LSM303)
+    # ...

docs/userguide/lib/cmd_register.rst

@@ -0,0 +1,26 @@
+.. _cmd_lib_register:
+
+platformio lib register
+=======================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio lib regiter [HTTP_URL_TO_LIBRARY.JSON]
+
+
+Description
+-----------
+
+Register new library and allow others to install it.
+
+Examples
+--------
+
+.. code-block:: bash
+
+    $ platformio lib register http://my.example.com/library.json

docs/userguide/lib/cmd_search.rst

@@ -0,0 +1,213 @@
+.. _cmd_lib_search:
+
+platformio lib search
+=====================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio lib search [OPTIONS] [QUERY]
+
+
+Description
+-----------
+
+Search for library in `PlatformIO Library Registry <http://platformio.org/#!/lib>`_
+by :ref:`library_config` fields in the boolean mode.
+
+The boolean search capability supports the following operators:
+
+.. list-table::
+    :header-rows:  1
+
+    * - Operator
+      - Description
+    * - ``+``
+      - A leading or trailing plus sign indicates that this word must be present
+        in library fields (see above) that is returned.
+    * - ``-``
+      - A leading or trailing minus sign indicates that this word must not be
+        present in any of the libraries that are returned.
+    * - ``(no operator)``
+      - By default (when neither ``+`` nor ``-`` is specified), the
+        word is optional, but the libraries that contain it are rated higher.
+    * - ``> <``
+      - These two operators are used to change a word's contribution to the
+        relevance value that is assigned to a library. The ``>`` operator
+        increases the contribution and the ``<`` operator decreases it.
+    * - ``( )``
+      - Parentheses group words into subexpressions. Parenthesized groups can
+        be nested.
+    * - ``~``
+      - A leading tilde acts as a negation operator, causing the word's
+        contribution to the library's relevance to be negative. This is useful for
+        marking "noise" words. A library containing such a word is rated lower than
+        others, but is not excluded altogether, as it would be with the ``-`` operator.
+    * - ``*``
+      - The asterisk serves as the truncation (or wildcard) operator. Unlike the
+        other operators, it is appended to the word to be affected. Words match if
+        they begin with the word preceding the ``*`` operator.
+    * - ``"``
+      - A phrase that is enclosed within double quote (``"``) characters matches
+        only libraries that contain the phrase literally, as it was typed.
+
+For more detail information please go to
+`MySQL Boolean Full-Text Searches <http://dev.mysql.com/doc/refman/5.6/en/fulltext-boolean.html>`_.
+
+Options
+-------
+
+.. option::
+    -a, --author
+
+Filter libraries by specified author
+
+.. option::
+    -k, --keyword
+
+Filter libraries by specified keyword
+
+
+.. option::
+    -f, --framework
+
+Filter libraries by specified framework
+
+
+.. option::
+    -p, --platform
+
+Filter libraries by specified keyword
+
+Examples
+--------
+
+1. List all libraries
+
+.. code-block:: bash
+
+    $ platformio lib search
+    # Found N libraries:
+    #
+    # [ ID  ] Name             Compatibility         "Authors": Description
+    # -------------------------------------------------------------------------------------
+    # [ 14  ] Adafruit-9DOF-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for the Adafruit 9DOF Breakout (L3GD20 / LSM303)
+    # [ 13  ] Adafruit-GFX     arduino, atmelavr     "Adafruit Industries": A core graphics library for all our displays, providing a common set of graphics primitives (points, lines, circles, etc.)
+    # [ 23  ] Adafruit-L3GD20-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for the L3GD20 Gyroscope
+    # [ 26  ] Adafruit-LSM303DLHC-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for Adafruit's LSM303 Breakout (Accelerometer + Magnetometer)
+    # [ 12  ] Adafruit-ST7735  arduino, atmelavr     "Adafruit Industries": A library for the Adafruit 1.8" SPI display
+    # [ 31  ] Adafruit-Unified-Sensor arduino, atmelavr     "Adafruit Industries": Adafruit Unified Sensor Driver
+    # [  4  ] IRremote         arduino, atmelavr     "Ken Shirriff": Send and receive infrared signals with multiple protocols
+    # [  1  ] OneWire          arduino, atmelavr     "Paul Stoffregen": Control devices (from Dallas Semiconductor) that use the One Wire protocol (DS18S20, DS18B20, DS2408 and etc)
+    # [  6  ] XBee             arduino, atmelavr     "Andrew Rapp": Arduino library for communicating with XBees in API mode
+    # [ 15  ] Adafruit-ADXL345-Unified arduino, atmelavr     "Adafruit Industries": Unified driver for the ADXL345 Accelerometer
+    # Show next libraries? [y/N]:
+    # ...
+
+2. Search for `1-Wire libraries <http://platformio.org/#!/lib/search?query=%25221-wire%2522>`_
+
+.. code-block:: bash
+
+    $ platformio lib search "1-wire"
+    # Found N libraries:
+    #
+    # [ ID  ] Name             Compatibility         "Authors": Description
+    # -------------------------------------------------------------------------------------
+    # [  1  ] OneWire          arduino, atmelavr     "Paul Stoffregen": Control devices (from Dallas Semiconductor) that use the One Wire protocol (DS18S20, DS18B20, DS2408 and etc)
+    # ...
+
+3. Search for `Arduino-based "I2C" libraries <http://platformio.org/#!/lib/search?query=framework%253Aarduino%2520i2c>`_
+
+.. code-block:: bash
+
+    $ platformio lib search "i2c" --framework="arduino"
+    # Found N libraries:
+    #
+    # [ ID  ] Name             Compatibility         "Authors": Description
+    # -------------------------------------------------------------------------------------
+    # [ 11  ] I2Cdevlib-Core   arduino, atmelavr     "Jeff Rowberg": The I2C Device Library (I2Cdevlib) is a collection of uniform and well-documented classes to provide simple and intuitive interfaces to I2C devices.
+    # [ 24  ] Adafruit-L3GD20  arduino, atmelavr     "Adafruit Industries": Driver for Adafruit's L3GD20 I2C Gyroscope Breakout
+    # [ 10  ] I2Cdevlib-AK8975 arduino, atmelavr     "Jeff Rowberg": AK8975 is 3-axis electronic compass IC with high sensitive Hall sensor technology
+    # [ 14  ] Adafruit-9DOF-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for the Adafruit 9DOF Breakout (L3GD20 / LSM303)
+    # ...
+
+4. Search for `libraries by "web" and "http" keywords <http://platformio.org/#!/lib/search?query=keyword%253A%2522web%2522%2520keyword%253A%2522http%2522>`_.
+
+.. code-block:: bash
+
+    $ platformio lib search --keyword="web" --keyword="http"
+    # Found N libraries:
+    #
+    # [ ID  ] Name             Compatibility         "Authors": Description
+    # -------------------------------------------------------------------------------------
+    # [  5  ] Webduino         arduino, atmelavr     "Ben Combee": An extensible web server library (for use with the Arduino WizNet Ethernet Shield)
+    # [ 17  ] Adafruit-CC3000  arduino, atmelavr     "Adafruit Industries": Library code for Adafruit's CC3000 Wi-Fi/WiFi breakouts
+    # ...
+
+5. Search for `libraries by "Adafruit Industries" author <http://platformio.org/#!/lib/search?query=author%253A%2522Adafruit%20Industries%2522>`_
+
+.. code-block:: bash
+
+    $ platformio lib search --author="Adafruit Industries"
+    # Found N libraries:
+    #
+    # [ ID  ] Name             Compatibility         "Authors": Description
+    # -------------------------------------------------------------------------------------
+    # [ 14  ] Adafruit-9DOF-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for the Adafruit 9DOF Breakout (L3GD20 / LSM303)
+    # [ 13  ] Adafruit-GFX     arduino, atmelavr     "Adafruit Industries": A core graphics library for all our displays, providing a common set of graphics primitives (points, lines, circles, etc.)
+    # [ 23  ] Adafruit-L3GD20-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for the L3GD20 Gyroscope
+    # [ 26  ] Adafruit-LSM303DLHC-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for Adafruit's LSM303 Breakout (Accelerometer + Magnetometer)
+    # ...
+
+6. Search for `libraries which are compatible with Dallas temperature sensors <http://platformio.org/#!/lib/search?query=DS*>`_
+   like DS18B20, DS18S20 and etc.
+
+.. code-block:: bash
+
+    $ platformio lib search "DS*"
+    # Found N libraries:
+    #
+    # [ ID  ] Name             Compatibility         "Authors": Description
+    # -------------------------------------------------------------------------------------
+    # [  1  ] OneWire          arduino, atmelavr     "Paul Stoffregen": Control devices (from Dallas Semiconductor) that use the One Wire protocol (DS18S20, DS18B20, DS2408 and etc)
+    # ...
+
+7. Search for `Energia-based *nRF24* or *HttpClient* libraries <http://platformio.org/#!/lib/search?query=framework%253Aenergia%2520%252B(nRF24%2520HttpClient)>`_.
+   The search query that is described below can be interpreted like
+   ``energia nRF24 OR energia HttpClient``
+
+.. code-block:: bash
+
+    $ platformio lib search "+(nRF24 HttpClient)" --framework="energia"
+    # Found 2 libraries:
+    #
+    # [ ID  ] Name             Compatibility         "Authors": Description
+    # -------------------------------------------------------------------------------------
+    # [ 46  ] HttpClient       energia, timsp430, titiva "Zack Lalanne": HttpClient is a library to make it easier to interact with web servers
+    # [ 43  ] nRF24            energia, timsp430     "Eric": The nRF24L01 is a low-cost 2.4GHz ISM transceiver module. It supports a number of channel frequencies in the 2.4GHz band and a range of data rates.
+
+
+8. Search for the `all sensor libraries excluding temperature <http://platformio.org/#!/lib/search?query=sensor%2520-temperature>`_.
+
+.. code-block:: bash
+
+    $ platformio lib search "sensor -temperature"
+    # Found N libraries:
+    #
+    # [ ID  ] Name             Compatibility         "Authors": Description
+    # -------------------------------------------------------------------------------------
+    # [ 31  ] Adafruit-Unified-Sensor arduino, atmelavr     "Adafruit Industries": Adafruit Unified Sensor Driver
+    # [ 10  ] I2Cdevlib-AK8975 arduino, atmelavr     "Jeff Rowberg": AK8975 is 3-axis electronic compass IC with high sensitive Hall sensor technology
+    # [ 14  ] Adafruit-9DOF-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for the Adafruit 9DOF Breakout (L3GD20 / LSM303)
+    # [ 23  ] Adafruit-L3GD20-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for the L3GD20 Gyroscope
+    # [ 26  ] Adafruit-LSM303DLHC-Unified arduino, atmelavr     "Adafruit Industries": Unified sensor driver for Adafruit's LSM303 Breakout (Accelerometer + Magnetometer)
+    # [ 33  ] Adafruit-TMP006  arduino, atmelavr     "Adafruit Industries": A library for the Adafruit TMP006 Infrared Thermopile Sensor
+    # [ 34  ] Adafruit-TSL2561-Unified arduino, atmelavr     "Adafruit Industries": Unified light sensor driver for Adafruit's TSL2561 breakouts
+    # [ 97  ] I2Cdevlib-BMA150 arduino, atmelavr     "Jeff Rowberg": The BMA150 is a triaxial, low-g acceleration sensor IC with digital output for consumer market applications
+    # [ 106 ] I2Cdevlib-MPR121 arduino, atmelavr     "Jeff Rowberg": The MPR121 is a 12-bit proximity capacitive touch sensor
+    # [ 111 ] I2Cdevlib-AK8975 energia, timsp430     "Jeff Rowberg": AK8975 is 3-axis electronic compass IC with high sensitive Hall sensor technology
+    # Show next libraries? [y/N]:

docs/userguide/lib/cmd_show.rst

@@ -0,0 +1,37 @@
+.. _cmd_lib_show:
+
+platformio lib show
+===================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio lib show ID
+
+
+Description
+-----------
+
+Show details about the installed library
+
+
+Examples
+--------
+
+.. code-block:: bash
+
+    # OneWire: http://platformio.org/#!/lib/show/1/OneWire
+    $ platformio lib show 1
+    # OneWire
+    # -------
+    # Authors: Paul Stoffregen <paul@pjrc.com> http://www.pjrc.com/teensy/td_libs_OneWire.html (maintainer), Jim Studt, Jason Dangel <dangel.jason@gmail.com>, Derek Yerger, Tom Pollard <pollard@alum.mit.edu>, Robin James
+    # Keywords: onewire, 1-wire, bus, sensor, temperature, ibutton
+    # Frameworks: arduino
+    # Platforms: atmelavr
+    # Version: 2.2
+    #
+    # Control devices (from Dallas Semiconductor) that use the One Wire protocol (DS18S20, DS18B20, DS2408 and etc)

docs/userguide/lib/cmd_uninstall.rst

@@ -0,0 +1,29 @@
+.. _cmd_lib_uninstall:
+
+platformio lib uninstall
+========================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio lib uninstall ID
+
+
+Description
+-----------
+
+Uninstall specified library
+
+
+Examples
+--------
+
+.. code-block:: bash
+
+    # XBee: http://platformio.org/#!/lib/show/6/XBee
+    $ platformio lib uninstall 6
+    # The library #6 'XBee' has been successfully uninstalled!

docs/userguide/lib/cmd_update.rst

@@ -0,0 +1,43 @@
+.. _cmd_lib_update:
+
+platformio lib update
+=====================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio lib update
+
+
+Description
+-----------
+
+Check or update installed libraries
+
+
+Examples
+--------
+
+.. code-block:: bash
+
+    $ platformio lib update
+    # Updating  [ 23 ] Adafruit-L3GD20-Unified library:
+    # Versions: Current=63de2eb9ea, Latest=63de2eb9ea 	 [Up-to-date]
+    # Updating  [ 12 ] Adafruit-ST7735 library:
+    # Versions: Current=e880eb1687, Latest=e880eb1687 	 [Up-to-date]
+    # Updating  [ 31 ] Adafruit-Unified-Sensor library:
+    # Versions: Current=88ae805bce, Latest=88ae805bce 	 [Up-to-date]
+    # Updating  [ 26 ] Adafruit-LSM303DLHC-Unified library:
+    # Versions: Current=59767208a8, Latest=59767208a8 	 [Up-to-date]
+    # Updating  [ 13 ] Adafruit-GFX library:
+    # Versions: Current=a9e5bc4707, Latest=a9e5bc4707 	 [Up-to-date]
+    # Updating  [ 1 ] OneWire library:
+    # Versions: Current=2.2, Latest=2.2 	 [Up-to-date]
+    # Updating  [ 4 ] IRremote library:
+    # Versions: Current=f2dafe5030, Latest=f2dafe5030 	 [Up-to-date]
+    # Updating  [ 14 ] Adafruit-9DOF-Unified library:
+    # Versions: Current=b2f07242ac, Latest=b2f07242ac 	 [Up-to-date]

docs/userguide/lib/index.rst

@@ -0,0 +1,23 @@
+.. _userguide_lib:
+
+Library Manager
+===============
+
+To print all available commands and options use:
+
+.. code-block:: bash
+
+    $ platformio lib --help
+    $ platformio lib COMMAND --help
+
+
+.. toctree::
+    :maxdepth: 2
+
+    cmd_install
+    cmd_list
+    cmd_register
+    cmd_search
+    cmd_show
+    cmd_uninstall
+    cmd_update

examples/ide-eclipse/README.rst

@@ -5,7 +5,7 @@ The detailed information and steps are described in this article:
 `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_.
 
 
-.. image:: http://www.ikravets.com/wp-content/uploads/2014/06/eclipse_build_arduino_pro5v-1024x822.png
+.. image:: http://www.ikravets.com/wp-content/uploads/2014/06/eclipse_platformio_build_arduino_uno.png
     :width: 850px
     :target: http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio
 

examples/ide-eclipse/arduino_pro5/.cproject

@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<?fileVersion 4.0.0?>
-
-<cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
+<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
 	<storageModule moduleId="org.eclipse.cdt.core.settings">
 		<cconfiguration id="0.910961921">
 			<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="0.910961921" moduleId="org.eclipse.cdt.core.settings" name="Default">
@@ -13,41 +11,46 @@
 					<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
 					<extension id="org.eclipse.cdt.core.GASErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
 					<extension id="org.eclipse.cdt.core.GLDErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
+					<extension id="org.eclipse.cdt.core.ELF" point="org.eclipse.cdt.core.BinaryParser"/>
 				</extensions>
 			</storageModule>
 			<storageModule moduleId="cdtBuildSystem" version="4.0.0">
 				<configuration artifactName="${ProjName}" buildProperties="" description="" id="0.910961921" name="Default" parent="org.eclipse.cdt.build.core.prefbase.cfg">
 					<folderInfo id="0.910961921." name="/" resourcePath="">
 						<toolChain id="org.eclipse.cdt.build.core.prefbase.toolchain.952979152" name="No ToolChain" resourceTypeBasedDiscovery="false" superClass="org.eclipse.cdt.build.core.prefbase.toolchain">
-							<targetPlatform id="org.eclipse.cdt.build.core.prefbase.toolchain.952979152.52310970" name=""/>
-							<builder id="org.eclipse.cdt.build.core.settings.default.builder.1519453406" keepEnvironmentInBuildfile="false" managedBuildOn="false" name="Gnu Make Builder" superClass="org.eclipse.cdt.build.core.settings.default.builder"/>
+							<targetPlatform binaryParser="org.eclipse.cdt.core.ELF" id="org.eclipse.cdt.build.core.prefbase.toolchain.952979152.52310970" name=""/>
+							<builder cleanBuildTarget="run --target clean" command="platformio" id="org.eclipse.cdt.build.core.settings.default.builder.1519453406" incrementalBuildTarget="run" keepEnvironmentInBuildfile="false" managedBuildOn="false" name="Gnu Make Builder" superClass="org.eclipse.cdt.build.core.settings.default.builder"/>
 							<tool id="org.eclipse.cdt.build.core.settings.holder.libs.1409095472" name="holder for library settings" superClass="org.eclipse.cdt.build.core.settings.holder.libs"/>
 							<tool id="org.eclipse.cdt.build.core.settings.holder.1624502120" name="Assembly" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.239157887" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/tools/toolchain/avr/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/frameworks/arduino/cores/arduino&quot;"/>
+								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.239157887" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
+									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
+									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-arduinoavr/cores/arduino&quot;"/>
 								</option>
-								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.922107295" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
+								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.922107295" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
 									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
 								</option>
 								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.149990277" languageId="org.eclipse.cdt.core.assembly" languageName="Assembly" sourceContentType="org.eclipse.cdt.core.asmSource" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
 							</tool>
 							<tool id="org.eclipse.cdt.build.core.settings.holder.54121539" name="GNU C++" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1096940598" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
+								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1096940598" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
 									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/tools/toolchain/avr/include&quot;"/>
 									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/frameworks/arduino/cores/arduino&quot;"/>
+									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
+									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-arduinoavr/cores/arduino&quot;"/>
 								</option>
-								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.1198905600" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
+								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.1198905600" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
 									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
 								</option>
 								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.762536863" languageId="org.eclipse.cdt.core.g++" languageName="GNU C++" sourceContentType="org.eclipse.cdt.core.cxxSource,org.eclipse.cdt.core.cxxHeader" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
 							</tool>
 							<tool id="org.eclipse.cdt.build.core.settings.holder.1310559623" name="GNU C" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.41298875" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
+								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.41298875" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
 									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/tools/toolchain/avr/include&quot;"/>
 									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/frameworks/arduino/cores/arduino&quot;"/>
+									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
+									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-arduinoavr/cores/arduino&quot;"/>
 								</option>
-								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.884639970" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
+								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.884639970" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
 									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
 								</option>
 								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.549319812" languageId="org.eclipse.cdt.core.gcc" languageName="GNU C" sourceContentType="org.eclipse.cdt.core.cSource,org.eclipse.cdt.core.cHeader" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
@@ -74,4 +77,5 @@
 			<resource resourceType="PROJECT" workspacePath="/arduino_pro5"/>
 		</configuration>
 	</storageModule>
+	<storageModule moduleId="org.eclipse.cdt.internal.ui.text.commentOwnerProjectMappings"/>
 </cproject>

examples/ide-eclipse/arduino_pro5/Makefile

@@ -1,5 +0,0 @@
-all: 
-	platformio run -t upload
-
-clean:
-	platformio run -t clean

examples/ide-eclipse/arduino_pro5/platformio.ini

@@ -4,5 +4,4 @@
 [env:arduino_pro5v]
 platform = atmelavr
 framework = arduino
-board = pro16MHzatmega168
-upload_port = /dev/tty.SLAB_USBtoUART
+board = pro16MHzatmega168

examples/ide-eclipse/atmelavr_atmega168/.cproject

@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<?fileVersion 4.0.0?>
-
-<cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
+<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
 	<storageModule moduleId="org.eclipse.cdt.core.settings">
 		<cconfiguration id="0.1706826288">
 			<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="0.1706826288" moduleId="org.eclipse.cdt.core.settings" name="Default">
@@ -13,18 +11,19 @@
 					<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
 					<extension id="org.eclipse.cdt.core.GASErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
 					<extension id="org.eclipse.cdt.core.GLDErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
+					<extension id="org.eclipse.cdt.core.ELF" point="org.eclipse.cdt.core.BinaryParser"/>
 				</extensions>
 			</storageModule>
 			<storageModule moduleId="cdtBuildSystem" version="4.0.0">
 				<configuration artifactName="${ProjName}" buildProperties="" description="" id="0.1706826288" name="Default" parent="org.eclipse.cdt.build.core.prefbase.cfg">
 					<folderInfo id="0.1706826288." name="/" resourcePath="">
 						<toolChain id="org.eclipse.cdt.build.core.prefbase.toolchain.944229927" name="No ToolChain" resourceTypeBasedDiscovery="false" superClass="org.eclipse.cdt.build.core.prefbase.toolchain">
-							<targetPlatform id="org.eclipse.cdt.build.core.prefbase.toolchain.944229927.1146791472" name=""/>
-							<builder id="org.eclipse.cdt.build.core.settings.default.builder.81097189" keepEnvironmentInBuildfile="false" managedBuildOn="false" name="Gnu Make Builder" superClass="org.eclipse.cdt.build.core.settings.default.builder"/>
+							<targetPlatform binaryParser="org.eclipse.cdt.core.ELF" id="org.eclipse.cdt.build.core.prefbase.toolchain.944229927.1146791472" name=""/>
+							<builder cleanBuildTarget="run --target clean" command="platformio" id="org.eclipse.cdt.build.core.settings.default.builder.81097189" incrementalBuildTarget="run" keepEnvironmentInBuildfile="false" managedBuildOn="false" name="Gnu Make Builder" superClass="org.eclipse.cdt.build.core.settings.default.builder"/>
 							<tool id="org.eclipse.cdt.build.core.settings.holder.libs.615700392" name="holder for library settings" superClass="org.eclipse.cdt.build.core.settings.holder.libs"/>
 							<tool id="org.eclipse.cdt.build.core.settings.holder.509191184" name="Assembly" superClass="org.eclipse.cdt.build.core.settings.holder">
 								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1976688999" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/tools/toolchain/avr/include&quot;"/>
+									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
 								</option>
 								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.1146079252" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
 									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
@@ -34,6 +33,7 @@
 							<tool id="org.eclipse.cdt.build.core.settings.holder.524184308" name="GNU C++" superClass="org.eclipse.cdt.build.core.settings.holder">
 								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1379816017" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
 									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/tools/toolchain/avr/include&quot;"/>
+									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
 								</option>
 								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.1180078676" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
 									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
@@ -43,6 +43,7 @@
 							<tool id="org.eclipse.cdt.build.core.settings.holder.746817635" name="GNU C" superClass="org.eclipse.cdt.build.core.settings.holder">
 								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.905883681" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
 									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/tools/toolchain/avr/include&quot;"/>
+									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
 								</option>
 								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.1589314232" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
 									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>

examples/ide-eclipse/atmelavr_atmega168/Makefile

@@ -1,5 +0,0 @@
-all: 
-	platformio run -t upload
-
-clean:
-	platformio run -t clean

examples/ide-eclipse/atmelavr_atmega168/platformio.ini

@@ -6,7 +6,9 @@ platform = atmelavr
 board_mcu = atmega168
 board_f_cpu = 16000000L
 
-upload_port = /dev/tty.SLAB_USBtoUART
+# Allow autodetection for upload port or uncomment line below
+# upload_port = /dev/ttyUSB0
 # upload_port = COM3
+
 upload_protocol = arduino
-upload_speed = 19200
+upload_speed = 19200