Merge branch 'release/v2.8.4'

* 'develop' of https://github.com/ivankravets/platformio:
  Allow using custom linker script for the libopenCM3 framework.

.gitignore

@@ -2,6 +2,6 @@
 *.pyc
 .pioenvs
 .tox
-.sconsign.dblite
 docs/_build
 dist
+build

HISTORY.rst

@@ -1,9 +1,199 @@
-Release History
-===============
+Release Notes
+=============
 
 PlatformIO 2.0
 --------------
 
+2.8.4 (2016-02-17)
+~~~~~~~~~~~~~~~~~~
+
+* Added support for the new ESP8266-based boards (ESPDuino, ESP-WROOM-02,
+  ESPresso Lite 1.0 & 2.0, SparkFun ESP8266 Thing Dev, ThaiEasyElec ESPino) to
+  `Espressif <http://docs.platformio.org/en/latest/platforms/espressif.html>`__
+  development platform
+* Added ``board_f_flash`` option to `Project Configuration File platformio.ini <http://docs.platformio.org/en/latest/projectconf.html>`__
+  which allows to specify `custom flash chip frequency <http://docs.platformio.org/en/latest/platforms/espressif.html#custom-flash-frequency>`_
+  for Espressif development platform
+  (`issue #501 <https://github.com/platformio/platformio/issues/501>`_)
+* Added ``board_flash_mode`` option to `Project Configuration File platformio.ini <http://docs.platformio.org/en/latest/projectconf.html>`__
+  which allows to specify `custom flash chip mode <http://docs.platformio.org/en/latest/platforms/espressif.html#custom-flash-mode>`_
+  for Espressif development platform
+* Handle new environment variables
+  `PLATFORMIO_UPLOAD_PORT <http://docs.platformio.org/en/latest/envvars.html#platformio-upload-port>`_
+  and `PLATFORMIO_UPLOAD_FLAGS <http://docs.platformio.org/en/latest/envvars.html#platformio-upload-flags>`_
+  (`IDE issue #518 <https://github.com/platformio/platformio/issues/518>`_)
+* Fixed issue with ``CPPDEFINES`` which contain space and break PlatformIO
+  IDE Linter
+  (`IDE issue #34 <https://github.com/platformio/platformio-atom-ide/issues/34>`_)
+* Fixed unable to link C++ standard library to Espressif platform build
+  (`issue #503 <https://github.com/platformio/platformio/issues/503>`_)
+* Fixed issue with pointer (``char* myfunc()``) while converting from ``*.ino``
+  to ``*.cpp``
+  (`issue #506 <https://github.com/platformio/platformio/issues/506>`_)
+
+2.8.3 (2016-02-02)
+~~~~~~~~~~~~~~~~~~
+
+* Better integration of PlatformIO Builder with PlatformIO IDE Linter
+* Fixed issue with removing temporary file while converting ``*.ino`` to
+  ``*.cpp``
+* Fixed missing dependency (mbed framework) for Atmel SAM development platform
+  (`issue #487 <https://github.com/platformio/platformio/issues/487>`_)
+
+2.8.2 (2016-01-29)
+~~~~~~~~~~~~~~~~~~
+
+* Corrected RAM size for NXP LPC1768 based boards
+  (`issue #484 <https://github.com/platformio/platformio/issues/484>`_)
+* Exclude only ``test`` and ``tests`` folders from build process
+* Reverted ``-Wl,-whole-archive`` hook for ST STM32 and mbed
+
+2.8.1 (2016-01-29)
+~~~~~~~~~~~~~~~~~~
+
+* Fixed a bug with Project Initialization in PlatformIO IDE
+
+2.8.0 (2016-01-29)
+~~~~~~~~~~~~~~~~~~
+
+* `PlatformIO IDE <http://docs.platformio.org/en/latest/ide/atom.html>`_ for
+  Atom
+  (`issue #470 <https://github.com/platformio/platformio/issues/470>`_)
+* Added ``pio`` command line alias for ``platformio`` command
+  (`issue #447 <https://github.com/platformio/platformio/issues/447>`_)
+* Added SPL-Framework support for Nucleo F401RE board
+  (`issue #453 <https://github.com/platformio/platformio/issues/453>`_)
+* Added ``upload_resetmethod`` option to `Project Configuration File platformio.ini <http://docs.platformio.org/en/latest/projectconf.html>`__
+  which allows to specify `custom upload reset method <http://docs.platformio.org/en/latest/platforms/espressif.html#custom-reset-method>`_
+  for Espressif development platform
+  (`issue #444 <https://github.com/platformio/platformio/issues/444>`_)
+* Allowed to force output of color ANSI-codes or to disable progress bar even
+  if the output is a ``pipe`` (not a ``tty``) using `Environment variables <http://docs.platformio.org/en/latest/envvars.html>`__
+  (`issue #465 <https://github.com/platformio/platformio/issues/465>`_)
+* Set 1Mb SPIFFS for Espressif boards by default
+  (`issue #458 <https://github.com/platformio/platformio/issues/458>`_)
+* Exclude ``test*`` folder by default from build process
+* Generate project for IDEs with information about installed libraries
+* Fixed builder for mbed framework and ST STM32 platform
+
+
+2.7.1 (2016-01-06)
+~~~~~~~~~~~~~~~~~~
+
+* Initial support for Arduino Zero board
+  (`issue #356 <https://github.com/platformio/platformio/issues/356>`_)
+* Added support for completions to Atom text editor using ``.clang_complete``
+* Generate default targets for `supported IDE <http://docs.platformio.org/en/latest/ide.html>`__
+  (CLion, Eclipse IDE, Emacs, Sublime Text, VIM): Build,
+  Clean, Upload, Upload SPIFFS image, Upload using Programmer, Update installed
+  platforms and libraries
+  (`issue #427 <https://github.com/platformio/platformio/issues/427>`_)
+* Updated Teensy Arduino Framework to 1.27
+  (`issue #434 <https://github.com/platformio/platformio/issues/434>`_)
+* Fixed uploading of EEPROM data using ``uploadeep`` target for Atmel AVR
+  development platform
+* Fixed project generator for CLion IDE
+  (`issue #422 <https://github.com/platformio/platformio/issues/422>`_)
+* Fixed package ``shasum`` validation on Mac OS X 10.11.2
+  (`issue #429 <https://github.com/platformio/platformio/issues/429>`_)
+* Fixed CMakeLists.txt ``add_executable`` has only one source file
+  (`issue #421 <https://github.com/platformio/platformio/issues/421>`_)
+
+2.7.0 (2015-12-30)
+~~~~~~~~~~~~~~~~~~
+
+**Happy New Year!**
+
+* Moved SCons to PlatformIO packages. PlatformIO does not require SCons to be
+  installed in your system. Significantly simplified installation process of
+  PlatformIO. ``pip install platformio`` rocks!
+* Implemented uploading files to file system of ESP8266 SPIFFS (including OTA)
+  (`issue #382 <https://github.com/platformio/platformio/issues/382>`_)
+* Added support for the new Adafruit boards Bluefruit Micro and Feather
+  (`issue #403 <https://github.com/platformio/platformio/issues/403>`_)
+* Added support for RFDuino
+  (`issue #319 <https://github.com/platformio/platformio/issues/319>`_)
+* Project generator for `Emacs <http://docs.platformio.org/en/latest/ide/emacs.html>`__
+  text editor
+  (`pull #404 <https://github.com/platformio/platformio/pull/404>`_)
+* Updated Arduino framework for Atmel AVR development platform to 1.6.7
+* Documented `firmware uploading for Atmel AVR development platform using
+  Programmers <http://docs.platformio.org/en/latest/platforms/atmelavr.html#upload-using-programmer>`_:
+  AVR ISP, AVRISP mkII, USBtinyISP, USBasp, Parallel Programmer and Arduino as ISP
+* Fixed issue with current Python interpreter for Python-based tools
+  (`issue #417 <https://github.com/platformio/platformio/issue/417>`_)
+
+2.6.3 (2015-12-21)
+~~~~~~~~~~~~~~~~~~
+
+* Restored support for Espressif ESP8266 ESP-01 1MB board (ready for OTA)
+* Fixed invalid ROM size for ESP8266-based boards
+  (`issue #396 <https://github.com/platformio/platformio/issues/396>`_)
+
+2.6.2 (2015-12-21)
+~~~~~~~~~~~~~~~~~~
+
+* Removed ``SCons`` from requirements list. PlatformIO will try to install it
+  automatically, otherwise users need to install it manually
+* Fixed ``ChunkedEncodingError`` when SF connection is broken
+  (`issue #356 <https://github.com/platformio/platformio/issues/356>`_)
+
+2.6.1 (2015-12-18)
+~~~~~~~~~~~~~~~~~~
+
+* Added support for the new ESP8266-based boards (SparkFun ESP8266 Thing,
+  NodeMCU 0.9 & 1.0, Olimex MOD-WIFI-ESP8266(-DEV), Adafruit HUZZAH ESP8266,
+  ESPino, SweetPea ESP-210, WeMos D1, WeMos D1 mini) to
+  `Espressif <http://docs.platformio.org/en/latest/platforms/espressif.html>`__
+  development platform
+* Created public `platformio-pkg-ldscripts <https://github.com/platformio/platformio-pkg-ldscripts.git>`_
+  repository for LD scripts. Moved common configuration for ESP8266 MCU to
+  ``esp8266.flash.common.ld``
+  (`issue #379 <https://github.com/platformio/platformio/issues/379>`_)
+* Improved documentation for `Espressif <http://docs.platformio.org/en/latest/platforms/espressif.html>`__
+  development platform: OTA update, custom Flash Size, Upload Speed and CPU
+  frequency
+* Fixed reset method for Espressif NodeMCU (ESP-12E Module)
+  (`issue #380 <https://github.com/platformio/platformio/issues/380>`_)
+* Fixed issue with code builder when build path contains spaces
+  (`issue #387 <https://github.com/platformio/platformio/issues/387>`_)
+* Fixed project generator for Eclipse IDE and "duplicate path entries found
+  in project path"
+  (`issue #383 <https://github.com/platformio/platformio/issues/383>`_)
+
+
+2.6.0 (2015-12-15)
+~~~~~~~~~~~~~~~~~~
+
+* Install only required packages depending on build environment
+  (`issue #308 <https://github.com/platformio/platformio/issues/308>`_)
+* Added support for Raspberry Pi `WiringPi <http://docs.platformio.org/en/latest/frameworks/wiringpi.html>`__
+  framework
+  (`issue #372 <https://github.com/platformio/platformio/issues/372>`_)
+* Implemented Over The Air (OTA) upgrades for `Espressif <http://docs.platformio.org/en/latest/platforms/espressif.html>`__
+  development platform.
+  (`issue #365 <https://github.com/platformio/platformio/issues/365>`_)
+* Updated `CMSIS framework <http://docs.platformio.org/en/latest/frameworks/cmsis.html>`__
+  and added CMSIS support for Nucleo F401RE board
+  (`issue #373 <https://github.com/platformio/platformio/issues/373>`_)
+* Added support for Espressif ESP8266 ESP-01-1MB board (ready for OTA)
+* Handle ``upload_flags`` option in `platformio.ini <http://docs.platformio.org/en/latest/projectconf.html>`__
+  (`issue #368 <https://github.com/platformio/platformio/issues/368>`_)
+* Improved PlatformIO installation on the Mac OS X El Capitan
+
+2.5.0 (2015-12-08)
+~~~~~~~~~~~~~~~~~~
+
+* Improved code builder for parallel builds (up to 4 times faster than before)
+* Generate `.travis.yml <http://docs.platformio.org/en/latest/ci/travis.html>`__
+  CI and `.gitignore` files for embedded projects by default
+  (`issue #354 <https://github.com/platformio/platformio/issues/354>`_)
+* Removed prompt with "auto-uploading" from `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`__
+  command and added ``--enable-auto-uploading`` option
+  (`issue #352 <https://github.com/platformio/platformio/issues/352>`_)
+* Fixed incorrect behaviour of `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`__
+  in pair with PySerial 3.0
+
 2.4.1 (2015-12-01)
 ~~~~~~~~~~~~~~~~~~
 
@@ -219,7 +409,7 @@ PlatformIO 2.0
 * Automatically detect upload port using VID:PID board settings
   (`issue #231 <https://github.com/platformio/platformio/issues/231>`_)
 * Improved detection of build changes
-* Avoided ``LibInstallDependencyError`` when more then 1 library is found
+* Avoided ``LibInstallDependencyError`` when more than 1 library is found
   (`issue #229 <https://github.com/platformio/platformio/issues/229>`_)
 
 2.1.0 (2015-06-03)

README.rst

@@ -28,16 +28,20 @@ PlatformIO
 .. image:: https://badges.gitter.im/Join%20Chat.svg
    :alt: Join the chat at https://gitter.im/platformio/platformio
    :target: https://gitter.im/platformio/platformio
+.. image:: https://img.shields.io/donate/PlatformIO.png?color=yellow
+   :alt: Donate for PlatformIO.Org
+   :target: http://platformio.org/#!/donate
+
 
 `Home & Demo <http://platformio.org>`_ |
+`PlatformIO IDE <http://platformio.org/#!/platformio-ide>`_ |
 `Project Examples <https://github.com/platformio/platformio/tree/develop/examples>`_ |
-`Source Code <https://github.com/platformio>`_ |
-`Documentation <http://docs.platformio.org>`_ |
-`Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
+`Docs <http://docs.platformio.org>`_ |
 `Twitter <https://twitter.com/PlatformIO_Org>`_ |
-`Hackaday <https://hackaday.io/project/7980-platformio>`_ |
 `Facebook <https://www.facebook.com/platformio>`_ |
-`Reddit <http://www.reddit.com/r/platformio/>`_
+`Hackaday <https://hackaday.io/project/7980-platformio>`_ |
+`Donate <http://platformio.org/#!/donate>`_ |
+`Contact Us <http://platformio.org/#!/contact>`_
 
 .. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-logo.png
     :target: http://platformio.org
@@ -46,6 +50,11 @@ PlatformIO
 development. Cross-platform code builder and library manager. Continuous and
 IDE integration. Arduino and MBED compatible. Ready for Cloud compiling.
 
+* **PlatformIO IDE** - The next generation integrated development environment for IoT.
+  C/C++ Intelligent Code Completion and Smart Code Linter for the super-fast coding.
+  Multi-projects workflow with Multiple Panes. Themes Support with dark and light colors.
+  Built-in Terminal with PlatformIO CLI tool and support for the powerful Serial Port Monitor.
+  All advanced instruments without leaving your favourite development environment.
 * **Development Platforms** - Embedded and Desktop development platforms with
   pre-built toolchains, debuggers, uploaders and frameworks which work under
   popular host OS: Mac, Windows, Linux (+ARM)
@@ -55,7 +64,7 @@ IDE integration. Arduino and MBED compatible. Ready for Cloud compiling.
 * **Library Manager** - Hundreds Popular Libraries are organized into single
   Web 2.0 platform: list by categories, keywords, authors, compatible
   platforms and frameworks; learn via examples; be up-to-date with the latest
-  version
+  version.
 
 *Atmel AVR & SAM, Espressif, Freescale Kinetis, Nordic nRF51, NXP LPC,
 Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed,
@@ -64,6 +73,7 @@ libOpenCM3, etc.*
 .. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-demo-wiring.gif
     :target: http://platformio.org
 
+* `PlatformIO IDE <http://platformio.org/#!/platformio-ide>`_
 * `Get Started <http://platformio.org/#!/get-started>`_
 * `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
 * `Development Platforms <http://platformio.org/#!/platforms>`_
@@ -75,7 +85,7 @@ libOpenCM3, etc.*
 * `IDE Integration <http://docs.platformio.org/en/latest/ide.html>`_
 * `Articles about us <http://docs.platformio.org/en/latest/articles.html>`_
 * `FAQ <http://docs.platformio.org/en/latest/faq.html>`_
-* `Release History <http://docs.platformio.org/en/latest/history.html>`_
+* `Release Notes <http://docs.platformio.org/en/latest/history.html>`_
 
 Use whenever. *Run everywhere.*
 -------------------------------
@@ -93,7 +103,7 @@ settings for most popular `Embedded Boards <http://platformio.org/#!/boards>`_.
 
 * Colourful `command-line output <https://raw.githubusercontent.com/platformio/platformio/develop/examples/platformio-examples.png>`_
 * `IDE Integration <http://docs.platformio.org/en/latest/ide.html>`_ with
-  *Arduino, Eclipse, Energia, Qt Creator, Sublime Text, Vim, Visual Studio*
+  *Arduino, Atom, Eclipse, Emacs, Energia, Qt Creator, Sublime Text, Vim, Visual Studio*
 * Cloud compiling and `Continuous Integration <http://docs.platformio.org/en/latest/ci/index.html>`_
   with *AppVeyor, Circle CI, Drone, Shippable, Travis CI*
 * Built-in `Serial Port Monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ and configurable
@@ -171,13 +181,33 @@ Frameworks:
 * `Energia <http://platformio.org/#!/frameworks/energia>`_
 * `SPL <http://platformio.org/#!/frameworks/spl>`_
 * `mbed <http://platformio.org/#!/frameworks/mbed>`_
+* `WiringPi <http://platformio.org/#!/frameworks/wiringpi>`_
 
 For further details, please refer to `What is PlatformIO? <http://docs.platformio.org/en/latest/faq.html#what-is-platformio>`_
 
+Contributing
+------------
+
+1. Fork the repository on GitHub.
+2. Make a branch off of ``develop``
+3. Run ``pip install tox``
+4. Go to the root of project where is located ``tox.ini`` and run ``tox -e develop``
+5. Activate current development environment:
+
+   * Windows: ``.tox\develop\Scripts\activate``
+   * Bash/ZSH: ``source .tox/develop/bin/activate``
+   * Fish: ``source .tox/bin/activate.fish``
+
+6. Make changes to code, documentation, etc.
+7. Lint source code ``tox -e lint``
+8. Run the tests ``tox -e py27``
+9. Commit changes to your forked repository
+10. Submit a Pull Request on GitHub.
+
 Licence
 -------
 
-Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
 
 The PlatformIO is licensed under the permissive Apache 2.0 licence,
 so you can use it in both commercial and personal projects with confidence.

docs/_static/extra.css

@@ -1,5 +1,5 @@
 /**
- * Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+ * Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -29,7 +29,8 @@ nav {
   margin-right: auto;
   margin-left: auto;
 }
-@media (min-width: 768px) {
+
+@media (min-width: 992px) {
   #pionav {
     display: block !important;
   }
@@ -39,11 +40,7 @@ nav {
   .wy-nav-side {
     top: 50px;
   }
-  .container {
-    width: 750px;
-  }
-}
-@media (min-width: 992px) {
+
   .container {
     width: 970px;
   }
@@ -94,6 +91,7 @@ nav {
   position: relative;
   display: block;
   padding: 10px 15px;
+  font-size: 14px;
 }
 .nav > li > a:hover,
 .nav > li > a:focus {
@@ -103,6 +101,9 @@ nav {
 .nav > li > a > img {
   max-width: none;
 }
+.nav > li > a > i {
+  margin-right: 5px;
+}
 
 .navbar {
   position: relative;
@@ -252,3 +253,26 @@ nav {
 .navbar-header .navbar-brand {
   color: #e0e0e0;
 }
+
+/* Misc */
+
+.top-banner {
+  display: block;
+  padding: 10px 20px;
+  font-weight: bold;
+  font-size: 14px;
+  color: #fff;
+  text-align: center;
+  background-color: #0275d8;
+}
+
+.top-banner:hover {
+  color: #fff;
+  text-decoration: none;
+  background-color: #025ebb;
+}
+
+.top-banner:visited {
+  color: #fff;
+  text-decoration: none;
+}

docs/_templates/footer.html

@@ -11,21 +11,46 @@
     <nav role="navigation">
       <div>
         <ul class="nav navbar-nav">
-          <li><a href="http://platformio.org/#!/get-started"><i class="fa fa-rocket fa-lg"></i> Get Started</a></li>
-          <li><a href="http://platformio.org/#!/platforms"><i class="fa fa-laptop fa-lg"></i> Platforms</a></li>
-          <li><a href="http://platformio.org/#!/frameworks"><i class="fa fa-cogs fa-lg"></i> Frameworks</a></li>
-          <li><a href="http://platformio.org/#!/boards"><i class="fa fa-gamepad fa-lg"></i> Boards</a></li>
-          <li ><a href="http://platformio.org/#!/lib"><i class="fa fa-code fa-lg"></i> Libraries</a></li>
+          <li><a href="http://platformio.org/#!/get-started"><i class="fa fa-rocket fa-lg"></i>Get Started</a></li>
+          <li><a href="http://platformio.org/#!/platforms"><i class="fa fa-laptop fa-lg"></i>Platforms</a></li>
+          <li><a href="http://platformio.org/#!/frameworks"><i class="fa fa-cogs fa-lg"></i>Frameworks</a></li>
+          <li><a href="http://platformio.org/#!/boards"><i class="fa fa-gamepad fa-lg"></i>Boards</a></li>
+          <li ><a href="http://platformio.org/#!/lib"><i class="fa fa-code fa-lg"></i>Libraries</a></li>
         </ul>
 
         <ul class="nav navbar-nav navbar-right">
-          <li><a href="http://platformio.org/#!/who-uses"><i class="fa fa-heart-o fa-lg"></i> Who uses</a></li>
-          <li class="active"><a href="http://docs.platformio.org/"><i class="fa fa-book fa-lg"></i> Docs</a></li>
+          <li><a href="http://platformio.org/#!/who-uses"><i class="fa fa-heart-o fa-lg"></i>Who uses</a></li>
+          <li class="active"><a href="http://docs.platformio.org/"><i class="fa fa-book fa-lg"></i>Docs</a></li>
         </ul>
       </div>
 
     </nav>
   </div>
 </header>
+<script>
+(function() {
+  var runMyCode = function($) {
+    $(window).ready(function() {
+        if ($('#pionav').css('display') !== 'block') {
+            return;
+        }
+        function fixScroll() {
+            $(window).scrollTop($(window).scrollTop() - 50);
+        }
+        window.setTimeout(fixScroll, 50);
+        $(window).on('hashchange', function(e){fixScroll();});
+    });
+  };
+
+  var timer = function() {
+    if (window.jQuery) {
+      runMyCode(window.jQuery);
+    } else {
+      window.setTimeout(timer, 50);
+    }
+  };
+  timer();
+})();
+</script>
 {{ super() }}
 {% endblock %}

docs/articles.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -20,15 +20,32 @@ Articles about us
 
 Here are recent articles about PlatformIO:
 
+2016
+^^^^
+
+* Jan 24, 2016 - **Sergey Prilukin** - `How to use IntelliJ IDEA to develop and upload software for micro controllers like Arduino <http://jandevblog.blogspot.com/2016/01/how-to-use-intellij-idea-to-develop-and.html>`_
+* Jan 16, 2016 - **Dani Eichhorn** - `ESP8266 Arduino IDE Alternative: PlatformIO <http://blog.squix.ch/2016/01/esp8266-arduino-ide-alternative.html>`_
+* Jan 11, 2016 - **David Mills, Ph.D.** - `STM NUCLEOF401RE TIMER IO <http://webshed.org/wiki/STM_NUCLEOF401RE_TIMER_IO>`_
+* Jan 05, 2016 - **Julien Rodrigues** - `Internet Of Things: The IDE scandal <https://medium.com/@jrodrigues/internet-of-things-the-ide-scandal-5ddb8fc9d918>`_
+
 2015
 ^^^^
 
+* Dec 22, 2015 - **Jan Penninkhof** - `Over-the-Air ESP8266 programming using PlatformIO <http://www.penninkhof.com/2015/12/1610-over-the-air-esp8266-programming-using-platformio/>`_
+* Dec 15, 2015 - **stastaka** - `PlatformIOでカスタムボードを使う (Use a custom board for PlatformIO, Japanese) <http://qiita.com/stastaka/items/a6a50dbbb2933bd78bdd>`_
+* Dec 08, 2015 - **Piotr Król** - `Using PlatformIO with TI MSP430 LunchPads <http://blog.3mdeb.com/2015/12/08/using-platformio-with-ti-msp430-lunchpads/>`_
+* Dec 01, 2015 - **Michał Seroczyński** - `Push Notification from Arduino Yún with motion sensor <http://www.ches.pl/push-from-yun-1/>`_
+* Dec 01, 2015 - **JetBrains CLion Blog** - `C++ Annotated: Fall 2015. Arduino Support in CLion using PlatformIO <http://blog.jetbrains.com/clion/2015/12/cpp-annotated-fall-2015/>`_
+* Dec 01, 2015 - **Tateno Yuichi** - `ESP8266 を CUI で開発する (Develop a ESP8266 in CUI, Japanese) <http://jaywiggins.com/platformio/arduino/avr/es8266/2015/09/30/platformio-investigation/>`_
 * Nov 29, 2015 - **Keith Hughes** - `Using PlatformIO for Embedded Projects <http://smartspacestuff.blogspot.com/2015/11/using-platformio-for-embedded-projects.html>`_
 * Nov 22, 2015 - **Michał Seroczyński** - `Using PlatformIO to get started with Arduino in CLion IDE <http://www.ches.pl/using-platformio-get-started-arduino-clion-ide/>`_
 * Nov 09, 2015 - **ÁLvaro García Gómez** - `Programar con Arduino "The good way" (Programming with Arduino "The good way", Spanish) <http://congdegnu.es/2015/11/09/programar-con-arduino-the-good-way/>`_
 * Nov 06, 2015 - **nocd5** - `PlatformIOでmbedをオフラインビルドしSTM32 Nucleoボードでmrubyを使う (Use mruby in the offline build for STM32 Nucleo board with mbed and PlatformIO, Japanese) <http://qiita.com/nocd5/items/d5fda776240f7e7c17eb>`_
+* Oct 21, 2015 - **Vittorio Zaccaria** - `Using a cheap STM32 Nucleo to teach remote sensor monitoring <http://www.vittoriozaccaria.net/blog/2015/10/21/using-a-cheap-stm32-nucleo-to-teach-remote-sensor-monitoring.html>`_
 * Oct 18, 2015 - **Nico Coetzee** - `First Arduino I2C Experience with PlatformIO <https://electronicventurer.wordpress.com/2015/10/18/first-arduino-i2c-experience/>`_
+* Oct 10, 2015 - **Floyd Hilton** - `Programming Arduino with Atom <http://floydhilton.com/software/career/2015/10/10/Arduino_with_Atom.html>`_
 * Oct 01, 2015 - **Mistan** - `Compile and Upload Arduino Sketch with PlatformIO for Raspberry Pi Running Arch Linux <http://tech.memoryimprintstudio.com/code-building-for-arduino-with-platformio-for-raspberry-pi-with-arch-linux/>`_
+* Sep 30, 2015 - **Jay Wiggins** - `PlatformIO Investigation <http://jaywiggins.com/platformio/arduino/avr/es8266/2015/09/30/platformio-investigation/>`_
 * Sep 01, 2015 - **Thomas P. Weldon, Ph.D.** - `Improvised MBED FRDM-K64F Eclipse/PlatformIO Setup and Software Installation <http://thomasweldon.com/tpw/courses/embeddsp/p00pcFrdmK64_eclipsePlatformioSetup.html>`_
 * Aug 08, 2015 - **Josh Glendenning** - `Armstrap Eagle and PlatformIO <http://isobit.io/2015/08/08/armstrap.html>`_
 * Aug 01, 2015 - **Russell Davis** - `PlatformIO on the Raspberry Pi <http://www.russelldavis.org/2015/08/01/platformio-on-the-raspberry-pi/>`_

docs/ci/appveyor.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/ci/circleci.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/ci/drone.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -50,7 +50,7 @@ Please fill all fields for your project in the Drone control panel:
 
 .. code-block:: bash
 
-    python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
+    pip install -U platformio
     platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
 
 .. image:: ../_static/droneci-platformio-integration-1.png
@@ -75,7 +75,7 @@ Examples
 
 .. code-block:: bash
 
-    python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
+    pip install -U platformio
     wget https://github.com/xxxajk/spi4teensy3/archive/master.zip -O /tmp/spi4teensy3.zip
     unzip /tmp/spi4teensy3.zip -d /tmp
     platformio ci --lib="." --lib="/tmp/spi4teensy3-master" --board=uno --board=teensy31 --board=due

docs/ci/index.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/ci/shippable.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -55,7 +55,7 @@ GitHub repository.
         - PLATFORMIO_CI_SRC=path/to/source/directory
 
     install:
-        - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
+        - pip install -U platformio
 
     script:
         - platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
@@ -81,7 +81,7 @@ Examples
         - PLATFORMIO_CI_SRC=examples/pl2303/pl2303_gps/pl2303_gps.ino
 
     install:
-        - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
+        - pip install -U platformio
         - wget https://github.com/xxxajk/spi4teensy3/archive/master.zip -O /tmp/spi4teensy3.zip
         - unzip /tmp/spi4teensy3.zip -d /tmp
 

docs/ci/travis.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -14,6 +14,13 @@
 Travis CI
 =========
 
+.. image:: ../_static/ci-travis-logo.png
+    :target: https://docs.travis-ci.com/user/integration/platformio/
+
+
+**Travis CI** `officially supports <https://docs.travis-ci.com/user/integration/platformio/>`_
+**PlatformIO for Embedded Builds.**
+
 `Travis CI <http://en.wikipedia.org/wiki/Travis_CI>`_ is an open-source hosted,
 distributed continuous integration service used to build and test projects
 hosted at `GitHub <http://en.wikipedia.org/wiki/GitHub>`_.

docs/conf.py

@@ -45,7 +45,7 @@ master_doc = 'index'
 
 # General information about the project.
 project = u'PlatformIO'
-copyright = u'2014-2015, Ivan Kravets'
+copyright = u'2014-2016, 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
@@ -69,7 +69,7 @@ release = platformio.__version__
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['_build']
+exclude_patterns = ['_build', '**/*_extra.rst']
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.

docs/demo.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -11,11 +11,16 @@
 
 .. _demo:
 
-Demo
-====
+Demo & Projects
+===============
 
 .. contents::
 
+Project Examples
+----------------
+
+Preconfigured demo projects are located in `PlatformIO GitHub <https://github.com/platformio/platformio/tree/develop/examples>`_ repository.
+
 Wiring Blink
 ------------
 
@@ -59,3 +64,15 @@ Used in demo
 7. :ref:`platformio lib install 124 --version "1.40" <cmd_lib_install>` command
 8. :ref:`platformio lib show 124 <cmd_lib_show>` command
 9. :ref:`cmd_lib_update` command.
+
+Over-the-Air update for ESP8266
+-------------------------------
+
+.. image:: _static/platformio-demo-ota-esp8266.jpg
+    :target: https://www.youtube.com/watch?v=lXchL3hpDO4
+
+Used in demo
+~~~~~~~~~~~~
+
+1. :ref:`cmd_run` command
+2. :ref:`platformio run -t upload <cmd_run>` command.

docs/envvars.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -34,10 +34,20 @@ operations/commands.
 PlatformIO handles ``CI`` variable which is setup by
 `Continuous Integration <http://en.wikipedia.org/wiki/Continuous_integration>`_
 (Travis, Circle and etc.) systems.
-Currently, PlatformIO uses it to disable prompts.
+PlatformIO uses it to disable prompts and progress bars. In other words,
+``CI=true`` automatically setup :envvar:`PLATFORMIO_SETTING_ENABLE_PROMPTS` to
+``false`` and :envvar:`PLATFORMIO_DISABLE_PROGRESSBAR` to ``true``.
 
-In other words, ``CI=true`` automatically setup
-:envvar:`PLATFORMIO_SETTING_ENABLE_PROMPTS=false <PLATFORMIO_SETTING_ENABLE_PROMPTS>`.
+.. envvar:: PLATFORMIO_FORCE_COLOR
+
+Force to output color ANSI-codes even if the output is a ``pipe`` (not a ``tty``).
+The possible values are ``true`` and ``false``. Default is ``PLATFORMIO_FORCE_COLOR=false``.
+
+.. envvar:: PLATFORMIO_DISABLE_PROGRESSBAR
+
+Disable progress bar for package/library downloader and uploader. This is
+useful when calling PlatformIO from subprocess and output is a ``pipe`` (not a ``tty``).
+The possible values are ``true`` and ``false``. Default is ``PLATFORMIO_DISABLE_PROGRESSBAR=false``.
 
 .. envvar:: PLATFORMIO_HOME_DIR
 
@@ -55,9 +65,13 @@ Allows to override :ref:`projectconf` option :ref:`projectconf_pio_src_dir`.
 
 Allows to override :ref:`projectconf` option :ref:`projectconf_pio_envs_dir`.
 
+.. envvar:: PLATFORMIO_DATA_DIR
 
-Builder
--------
+Allows to override :ref:`projectconf` option :ref:`projectconf_pio_data_dir`.
+
+
+Building
+--------
 
 .. envvar:: PLATFORMIO_BUILD_FLAGS
 
@@ -76,6 +90,18 @@ Allows to set :ref:`projectconf` option :ref:`projectconf_src_filter`.
 Allows to set :ref:`projectconf` option :ref:`projectconf_extra_script`.
 
 
+Uploading
+---------
+
+.. envvar:: PLATFORMIO_UPLOAD_PORT
+
+Allows to set :ref:`projectconf` option :ref:`projectconf_upload_port`.
+
+.. envvar:: PLATFORMIO_UPLOAD_FLAGS
+
+Allows to set :ref:`projectconf` option :ref:`projectconf_upload_flags`.
+
+
 Settings
 --------
 

docs/faq.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -41,7 +41,7 @@ console application, it can be used in combination with one's favorite
 
 Alright, so PlatformIO can run on different operating systems. But more
 importantly, from development perspective at least, is a list of supported
-boards and MCUs. To keep things short: PlatformIO supports over 150+
+boards and MCUs. To keep things short: PlatformIO supports approximately 200
 `Embedded Boards <http://platformio.org/#!/boards>`_ and all major
 :ref:`Development Platforms <platforms>`.
 
@@ -79,6 +79,7 @@ Bash completion for `platformio` subcommands you need to put into your `.bashrc`
 .. code-block:: bash
 
     eval "$(_PLATFORMIO_COMPLETE=source platformio)"
+    eval "$(_PLATFORMIO_COMPLETE=source pio)"
 
 ZSH completion
 ''''''''''''''
@@ -89,6 +90,7 @@ To enable ``zsh`` completion please run these commands:
 
     autoload bashcompinit && bashcompinit
     eval "$(_PLATFORMIO_COMPLETE=source platformio)"
+    eval "$(_PLATFORMIO_COMPLETE=source pio)"
 
 .. note::
 
@@ -103,30 +105,6 @@ Troubleshooting
 Installation
 ~~~~~~~~~~~~
 
-PlatformIO and SCons aren't installed properly
-''''''''''''''''''''''''''''''''''''''''''''''
-
-Try these solutions:
-
-1. Upgrade SCons via `pip <https://pip.pypa.io>`_
-
-.. code-block:: bash
-
-    [sudo] pip uninstall scons
-    [sudo] pip install scons
-
-    # or if you have "error: option --single-version-externally-managed not recognized"
-    [sudo] pip install --egg scons
-
-2. Install PlatformIO using :ref:`installation_installer_script`.
-
-.. _faq_troubleshooting_sconssingverextmanaged:
-
-PIP & SCons Error: option --single-version-externally-managed not recognized
-''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-Answered in `issue #279 <https://github.com/platformio/platformio/issues/279>`_.
-
 [Errno 1] Operation not permitted
 '''''''''''''''''''''''''''''''''
 
@@ -139,8 +117,8 @@ Answered in `issue #252 <https://github.com/platformio/platformio/issues/252#iss
 
 .. _faq_troubleshooting_pionotfoundinpath:
 
-Program ``platformio`` not found in PATH
-''''''''''''''''''''''''''''''''''''''''
+Program "platformio" not found in PATH
+''''''''''''''''''''''''''''''''''''''
 
 Where is ``platformio`` binary installed? Run this command in Terminal
 
@@ -158,8 +136,8 @@ For example, ``which platformio`` is equal to ``/usr/local/bin/platformio``,
 then `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_
 should contain ``/usr/local/bin`` directory.
 
-**Unix Users**: You can make "symlinks" from ``platformio`` and ``scons``
-programs to the ``bin`` directory which is included in ``$PATH``. For example,
+**Unix Users**: You can make "symlinks" from ``platformio`` program to the
+``bin`` directory which is included in ``$PATH``. For example,
 see `issue #272 <https://github.com/platformio/platformio/issues/272#issuecomment-133626112>`_.
 
 Windows UnicodeDecodeError: 'ascii' codec can't decode byte
@@ -223,3 +201,8 @@ Archlinux: libncurses.so.5: cannot open shared object file
 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 
 Answered in `issue #291 <https://github.com/platformio/platformio/issues/291>`_.
+
+Monitoring a serial port breaks upload
+''''''''''''''''''''''''''''''''''''''
+
+Answered in `issue #384 <https://github.com/platformio/platformio/issues/384>`_.

docs/frameworks/arduino.rst

@@ -1,3 +1,14 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _framework_arduino:
 
 Framework ``arduino``
@@ -25,6 +36,9 @@ Platforms
     * - :ref:`platform_espressif`
       - Espressif Systems is a privately held fabless semiconductor company. They provide wireless communications and Wi-Fi chips which are widely used in mobile devices and the Internet of Things applications.
 
+    * - :ref:`platform_nordicnrf51`
+      - The Nordic nRF51 Series is a family of highly flexible, multi-protocol, system-on-chip (SoC) devices for ultra-low power wireless applications. nRF51 Series devices support a range of protocol stacks including Bluetooth Smart (previously called Bluetooth low energy), ANT and proprietary 2.4GHz protocols such as Gazell.
+
     * - :ref:`platform_teensy`
       - Teensy is a complete USB-based microcontroller development system, in a very small footprint, capable of implementing many types of projects. All programming is done via the USB port. No special programmer is needed, only a standard "Mini-B" USB cable and a PC or Macintosh with a USB port.
 
@@ -52,6 +66,20 @@ Adafruit
       - Flash
       - RAM
 
+    * - ``bluefruitmicro``
+      - `Adafruit Bluefruit Micro <https://www.adafruit.com/products/2661>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``feather32u4``
+      - `Adafruit Feather <https://learn.adafruit.com/adafruit-feather-32u4-bluefruit-le/>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
     * - ``flora8``
       - `Adafruit Flora <http://www.adafruit.com/product/659>`_
       - ATMEGA32U4
@@ -66,6 +94,20 @@ Adafruit
       - 8 Kb
       - 0.5 Kb
 
+    * - ``huzzah``
+      - `Adafruit HUZZAH ESP8266 <https://www.adafruit.com/products/2471>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+    * - ``metro``
+      - `Adafruit Metro <https://www.adafruit.com/products/2466>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
     * - ``protrinket3``
       - `Adafruit Pro Trinket 3V/12MHz (USB) <http://www.adafruit.com/products/2010>`_
       - ATMEGA328P
@@ -172,14 +214,14 @@ Arduino
 
     * - ``due``
       - `Arduino Due (Programming Port) <http://arduino.cc/en/Main/arduinoBoardDue>`_
-      - AT91SAM3X8E
+      - SAM3X8E
       - 84 MHz
       - 512 Kb
       - 32 Kb
 
     * - ``dueUSB``
       - `Arduino Due (USB Native Port) <http://arduino.cc/en/Main/arduinoBoardDue>`_
-      - AT91SAM3X8E
+      - SAM3X8E
       - 84 MHz
       - 512 Kb
       - 32 Kb
@@ -338,6 +380,20 @@ Arduino
       - 32 Kb
       - 2.5 Kb
 
+    * - ``zero``
+      - `Arduino Zero (Programming Port) <https://www.arduino.cc/en/Main/ArduinoBoardZero>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``zeroUSB``
+      - `Arduino Zero (USB Native Port) <https://www.arduino.cc/en/Main/ArduinoBoardZero>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
 BQ
 ~~
 
@@ -352,7 +408,7 @@ BQ
       - RAM
 
     * - ``zumbt328``
-      - `BQ ZUM BT-328 board <http://www.bq.com/gb/products/zum.html>`_
+      - `BQ ZUM BT-328 <http://www.bq.com/gb/products/zum.html>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
@@ -426,6 +482,46 @@ Digistump
       - 512 Kb
       - 28 Kb
 
+Doit
+~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``espduino``
+      - `ESPDuino (ESP-13 Module) <https://www.tindie.com/products/doit/espduinowifi-uno-r3/>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+ESPino
+~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``espino``
+      - `ESPino <http://www.espino.io>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
 Engduino
 ~~~~~~~~
 
@@ -474,18 +570,46 @@ Espressif
       - RAM
 
     * - ``esp01``
-      - `Espressif ESP8266 ESP-01 board <https://nurdspace.nl/ESP8266>`_
-      - ESP8266
-      - 40 MHz
-      - 512 Kb
-      - 32 Kb
-
-    * - ``esp12e``
-      - `Espressif ESP8266 ESP-12E board (NodeMCU) <https://nurdspace.nl/ESP8266>`_
+      - `Espressif Generic ESP8266 ESP-01 512k <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
       - ESP8266
       - 80 MHz
       - 512 Kb
-      - 32 Kb
+      - 80 Kb
+
+    * - ``esp01_1m``
+      - `Espressif Generic ESP8266 ESP-01 1M <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 1024 Kb
+      - 80 Kb
+
+    * - ``esp12e``
+      - `Espressif ESP8266 ESP-12E <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+    * - ``esp_wroom_02``
+      - `ESP-WROOM-02 <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 50 Kb
+
+    * - ``espresso_lite_v1``
+      - `ESPresso Lite 1.0 <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+    * - ``espresso_lite_v2``
+      - `ESPresso Lite 2.0 <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
 
 LightUp
 ~~~~~~~
@@ -610,6 +734,53 @@ Microduino
       - 64 Kb
       - 4 Kb
 
+NodeMCU
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``nodemcu``
+      - `NodeMCU 0.9 (ESP-12 Module) <http://www.nodemcu.com/>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+    * - ``nodemcuv2``
+      - `NodeMCU 1.0 (ESP-12E Module) <http://www.nodemcu.com/>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+Olimex
+~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``modwifi``
+      - `Olimex MOD-WIFI-ESP8266(-DEV) <https://www.olimex.com/Products/IoT/MOD-WIFI-ESP8266-DEV/open-source-hardware>`_
+      - ESP8266
+      - 80 MHz
+      - 2048 Kb
+      - 80 Kb
+
 PanStamp
 ~~~~~~~~
 
@@ -677,6 +848,26 @@ Quirkbot
       - 32 Kb
       - 2.5 Kb
 
+RFduino
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``rfduino``
+      - `RFduino <http://www.rfduino.com/product/rfd22102-rfduino-dip/index.html>`_
+      - NRF51822
+      - 16 MHz
+      - 128 Kb
+      - 8 Kb
+
 RedBearLab
 ~~~~~~~~~~
 
@@ -875,6 +1066,20 @@ SparkFun
       - 32 Kb
       - 2 Kb
 
+    * - ``thing``
+      - `SparkFun ESP8266 Thing <https://www.sparkfun.com/products/13231>`_
+      - ESP8266
+      - 80 MHz
+      - 512 Kb
+      - 80 Kb
+
+    * - ``thingdev``
+      - `SparkFun ESP8266 Thing Dev <https://www.sparkfun.com/products/13231>`_
+      - ESP8266
+      - 80 MHz
+      - 512 Kb
+      - 80 Kb
+
     * - ``uview``
       - `SparkFun MicroView <https://www.sparkfun.com/products/12923>`_
       - ATMEGA328P
@@ -882,6 +1087,26 @@ SparkFun
       - 32 Kb
       - 2 Kb
 
+SweetPea
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``esp210``
+      - `SweetPea ESP-210 <http://wiki.sweetpeas.se/index.php?title=ESP-210>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
 Teensy
 ~~~~~~
 
@@ -917,7 +1142,7 @@ Teensy
       - 16 Kb
 
     * - ``teensy31``
-      - `Teensy 3.1 <https://www.pjrc.com/store/teensy31.html>`_
+      - `Teensy 3.1 / 3.2 <https://www.pjrc.com/store/teensy31.html>`_
       - MK20DX256
       - 72 MHz
       - 256 Kb
@@ -930,6 +1155,26 @@ Teensy
       - 64 Kb
       - 8 Kb
 
+ThaiEasyElec
+~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``espinotee``
+      - `ThaiEasyElec ESPino <http://www.thaieasyelec.com/products/wireless-modules/wifi-modules/espino-wifi-development-board-detail.html>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
 TinyCircuits
 ~~~~~~~~~~~~
 
@@ -957,6 +1202,33 @@ TinyCircuits
       - 32 Kb
       - 2 Kb
 
+WeMos
+~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``d1``
+      - `WeMos D1(Retired) <http://www.wemos.cc/wiki/doku.php?id=en:d1>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+    * - ``d1_mini``
+      - `WeMos D1 R2 & mini <http://www.wemos.cc/wiki/doku.php?id=en:d1_mini>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
 Wicked Device
 ~~~~~~~~~~~~~
 

docs/frameworks/cmsis.rst

@@ -1,3 +1,14 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _framework_cmsis:
 
 Framework ``cmsis``
@@ -94,3 +105,12 @@ ST
       - 32 MHz
       - 128 Kb
       - 16 Kb
+
+    * - ``nucleo_f401re``
+      - `ST Nucleo F401RE <https://developer.mbed.org/platforms/ST-Nucleo-F401RE/>`_
+      - STM32F401RET6
+      - 84 MHz
+      - 512 Kb
+      - 96 Kb
+
+.. include:: cmsis_extra.rst

docs/frameworks/cmsis_extra.rst

@@ -0,0 +1,25 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+Articles
+--------
+
+* Jan 11, 2016 - **David Mills, Ph.D.** - `STM NUCLEOF401RE TIMER IO <http://webshed.org/wiki/STM_NUCLEOF401RE_TIMER_IO>`_
+
+See more :ref:`articles`.
+
+Examples
+--------
+
+All project examples are located in PlatformIO repository
+`Examples for CMSIS framework <https://github.com/platformio/platformio/tree/develop/examples/stm32>`_.
+
+* `Blink <https://github.com/platformio/platformio/tree/develop/examples/stm32/stm32-cmsis-blink>`_

docs/frameworks/energia.rst

@@ -1,3 +1,14 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _framework_energia:
 
 Framework ``energia``

docs/frameworks/index.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -23,3 +23,4 @@ Frameworks
     libopencm3
     mbed
     spl
+    wiringpi

docs/frameworks/libopencm3.rst

@@ -1,3 +1,14 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _framework_libopencm3:
 
 Framework ``libopencm3``
@@ -104,3 +115,5 @@ TI
       - 120 MHz
       - 1024 Kb
       - 256 Kb
+
+.. include:: libopencm3_extra.rst

docs/frameworks/libopencm3_extra.rst

@@ -0,0 +1,18 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+Examples
+--------
+
+All project examples are located in PlatformIO repository
+`Examples for libOpenCM3 framework <https://github.com/platformio/platformio/tree/develop/examples/stm32>`_.
+
+* `Blink <https://github.com/platformio/platformio/tree/develop/examples/stm32/stm32-opencm3-blink>`_

docs/frameworks/mbed.rst

@@ -1,3 +1,14 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _framework_mbed:
 
 Framework ``mbed``
@@ -16,6 +27,9 @@ Platforms
     * - Name
       - Description
 
+    * - :ref:`platform_atmelsam`
+      - Atmel | SMART offers Flash- based ARM products based on the ARM Cortex-M0+, Cortex-M3 and Cortex-M4 architectures, ranging from 8KB to 2MB of Flash including a rich peripheral and feature mix.
+
     * - :ref:`platform_freescalekinetis`
       - Freescale Kinetis Microcontrollers is family of multiple hardware- and software-compatible ARM Cortex-M0+, Cortex-M4 and Cortex-M7-based MCU series. Kinetis MCUs offer exceptional low-power performance, scalability and feature integration.
 
@@ -42,6 +56,40 @@ Boards
       `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
     * For more detailed ``board`` information please scroll tables below by horizontal.
 
+Atmel
+~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``samd21_xpro``
+      - `Atmel SAMD21-XPRO <https://developer.mbed.org/platforms/SAMD21-XPRO/>`_
+      - ATSAMD21J18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``saml21_xpro_b``
+      - `Atmel SAML21-XPRO-B <https://developer.mbed.org/platforms/SAML21-XPRO/>`_
+      - ATSAML21J18B
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``samr21_xpro``
+      - `Atmel ATSAMR21-XPRO <https://developer.mbed.org/platforms/SAMR21-XPRO/>`_
+      - ATSAMR21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
 CQ Publishing
 ~~~~~~~~~~~~~
 
@@ -250,7 +298,7 @@ NXP
       - LPC1768
       - 96 MHz
       - 512 Kb
-      - 32 Kb
+      - 64 Kb
 
 Nordic
 ~~~~~~
@@ -395,6 +443,13 @@ ST
       - 2048 Kb
       - 256 Kb
 
+    * - ``disco_f469ni``
+      - `ST 32F469IDISCOVERY <http://www.st.com/web/catalog/tools/FM116/CL1620/SC959/SS1532/LN1848/PF262395>`_
+      - STM32F469NIH6
+      - 180 MHz
+      - 1024 Kb
+      - 384 Kb
+
     * - ``disco_l053c8``
       - `ST 32L0538DISCOVERY <http://www.st.com/web/en/catalog/tools/PF260319>`_
       - STM32L053C8T6
@@ -402,6 +457,13 @@ ST
       - 64 Kb
       - 8 Kb
 
+    * - ``disco_l476vg``
+      - `ST 32L476GDISCOVERY <http://www.st.com/web/catalog/tools/FM116/CL1620/SC959/SS1532/LN1848/PF261635>`_
+      - STM32L476VGT6
+      - 80 MHz
+      - 1024 Kb
+      - 128 Kb
+
     * - ``nucleo_f030r8``
       - `ST Nucleo F030R8 <https://developer.mbed.org/platforms/ST-Nucleo-F030R8/>`_
       - STM32F030R8T6
@@ -409,6 +471,20 @@ ST
       - 64 Kb
       - 8 Kb
 
+    * - ``nucleo_f031k6``
+      - `ST Nucleo F031K6 <https://developer.mbed.org/platforms/ST-Nucleo-F031K6/>`_
+      - STM32F031K6T6
+      - 48 MHz
+      - 32 Kb
+      - 4 Kb
+
+    * - ``nucleo_f042k6``
+      - `ST Nucleo F042K6 <https://developer.mbed.org/platforms/ST-Nucleo-F042K6/>`_
+      - STM32F042K6T6
+      - 48 MHz
+      - 32 Kb
+      - 6 Kb
+
     * - ``nucleo_f070rb``
       - `ST Nucleo F070RB <https://developer.mbed.org/platforms/ST-Nucleo-F070RB/>`_
       - STM32F070RBT6
@@ -444,6 +520,13 @@ ST
       - 64 Kb
       - 16 Kb
 
+    * - ``nucleo_f303k8``
+      - `ST Nucleo F303K8 <https://developer.mbed.org/platforms/ST-Nucleo-F303K8/>`_
+      - STM32F303K8T6
+      - 72 MHz
+      - 64 Kb
+      - 16 Kb
+
     * - ``nucleo_f303re``
       - `ST Nucleo F303RE <http://developer.mbed.org/platforms/ST-Nucleo-F303RE/>`_
       - STM32F303RET6
@@ -493,6 +576,13 @@ ST
       - 512 Kb
       - 80 Kb
 
+    * - ``nucleo_l476rg``
+      - `ST Nucleo L476RG <https://developer.mbed.org/platforms/ST-Nucleo-L476RG/>`_
+      - STM32L476RGT6
+      - 80 MHz
+      - 1024 Kb
+      - 128 Kb
+
 SeeedStudio
 ~~~~~~~~~~~
 
@@ -518,7 +608,7 @@ SeeedStudio
       - LPC1768
       - 96 MHz
       - 512 Kb
-      - 32 Kb
+      - 64 Kb
 
 Silicon Labs
 ~~~~~~~~~~~~
@@ -629,7 +719,7 @@ Teensy
       - RAM
 
     * - ``teensy31``
-      - `Teensy 3.1 <https://www.pjrc.com/store/teensy31.html>`_
+      - `Teensy 3.1 / 3.2 <https://www.pjrc.com/store/teensy31.html>`_
       - MK20DX256
       - 72 MHz
       - 256 Kb
@@ -653,4 +743,6 @@ u-blox
       - LPC1768
       - 96 MHz
       - 512 Kb
-      - 32 Kb
+      - 64 Kb
+
+.. include:: mbed_extra.rst

docs/frameworks/mbed_extra.rst

@@ -0,0 +1,32 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+Articles
+--------
+
+* Dec 15, 2015 - **stastaka** - `PlatformIOでカスタムボードを使う (Use a custom board for PlatformIO, Japanese) <http://qiita.com/stastaka/items/a6a50dbbb2933bd78bdd>`_
+* Nov 06, 2015 - **nocd5** - `PlatformIOでmbedをオフラインビルドしSTM32 Nucleoボードでmrubyを使う (Use mruby in the offline build for STM32 Nucleo board with mbed and PlatformIO, Japanese) <http://qiita.com/nocd5/items/d5fda776240f7e7c17eb>`_
+* Oct 21, 2015 - **Vittorio Zaccaria** - `Using a cheap STM32 Nucleo to teach remote sensor monitoring <http://www.vittoriozaccaria.net/blog/2015/10/21/using-a-cheap-stm32-nucleo-to-teach-remote-sensor-monitoring.html>`_
+* Sep 01, 2015 - **Thomas P. Weldon, Ph.D.** - `Improvised MBED FRDM-K64F Eclipse/PlatformIO Setup and Software Installation <http://thomasweldon.com/tpw/courses/embeddsp/p00pcFrdmK64_eclipsePlatformioSetup.html>`_
+
+See more :ref:`articles`.
+
+Examples
+--------
+
+All project examples are located in PlatformIO repository
+`Examples for MBED framework <https://github.com/platformio/platformio/tree/develop/examples/mbed>`_.
+
+* `Blink <https://github.com/platformio/platformio/tree/develop/examples/mbed/mbed-blink>`_
+* `DSP <https://github.com/platformio/platformio/tree/develop/examples/mbed/mbed-dsp>`_
+* `HTTP Client <https://github.com/platformio/platformio/tree/develop/examples/mbed/mbed-http-client>`_
+* `RTOS <https://github.com/platformio/platformio/tree/develop/examples/mbed/mbed-rtos>`_
+* `Serial <https://github.com/platformio/platformio/tree/develop/examples/mbed/mbed-serial>`_

docs/frameworks/spl.rst

@@ -1,3 +1,14 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _framework_spl:
 
 Framework ``spl``
@@ -94,3 +105,12 @@ ST
       - 32 MHz
       - 128 Kb
       - 16 Kb
+
+    * - ``nucleo_f401re``
+      - `ST Nucleo F401RE <https://developer.mbed.org/platforms/ST-Nucleo-F401RE/>`_
+      - STM32F401RET6
+      - 84 MHz
+      - 512 Kb
+      - 96 Kb
+
+.. include:: spl_extra.rst

docs/frameworks/spl_extra.rst

@@ -0,0 +1,18 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+Examples
+--------
+
+All project examples are located in PlatformIO repository
+`Examples for SPL framework <https://github.com/platformio/platformio/tree/develop/examples/stm32>`_.
+
+* `Blink <https://github.com/platformio/platformio/tree/develop/examples/stm32/stm32-spl-blink>`_

docs/frameworks/wiringpi.rst

@@ -0,0 +1,75 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+.. _framework_wiringpi:
+
+Framework ``wiringpi``
+======================
+WiringPi is a GPIO access library written in C for the BCM2835 used in the Raspberry Pi. It's designed to be familiar to people who have used the Arduino "wiring" system.
+
+For more detailed information please visit `vendor site <http://wiringpi.com>`_.
+
+.. contents::
+
+Platforms
+---------
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Description
+
+    * - :ref:`platform_linux_arm`
+      - Linux ARM is a Unix-like and mostly POSIX-compliant computer operating system (OS) assembled under the model of free and open-source software development and distribution. Using host OS (Mac OS X, Linux ARM) you can build native application for Linux ARM platform.
+
+Boards
+------
+
+.. note::
+    * You can list pre-configured boards by :ref:`cmd_boards` command or
+      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
+    * For more detailed ``board`` information please scroll tables below by horizontal.
+
+Raspberry Pi
+~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``raspberrypi_1b``
+      - `Raspberry Pi 1 Model B <https://www.raspberrypi.org>`_
+      - BCM2835
+      - 700 MHz
+      - 524288 Kb
+      - 524288 Kb
+
+    * - ``raspberrypi_2b``
+      - `Raspberry Pi 2 Model B <https://www.raspberrypi.org>`_
+      - BCM2836
+      - 900 MHz
+      - 1048576 Kb
+      - 1048576 Kb
+
+    * - ``raspberrypi_zero``
+      - `Raspberry Pi Zero <https://www.raspberrypi.org>`_
+      - BCM2835
+      - 1000 MHz
+      - 524288 Kb
+      - 524288 Kb
+
+.. include:: wiringpi_extra.rst

docs/frameworks/wiringpi_extra.rst

@@ -0,0 +1,19 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+Examples
+--------
+
+All project examples are located in PlatformIO repository
+`Examples for WiringPi framework <https://github.com/platformio/platformio/tree/develop/examples/raspberrypi>`_.
+
+* `Blink <https://github.com/platformio/platformio/tree/develop/examples/raspberrypi/wiringpi-blink>`_
+* `Serial <https://github.com/platformio/platformio/tree/develop/examples/raspberrypi/wiringpi-serial>`_

docs/history.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/ide.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -17,10 +17,11 @@ IDE Integration
 .. toctree::
     :maxdepth: 2
 
-    ide/arduino
     ide/atom
+    ide/arduino
     ide/clion
     ide/eclipse
+    ide/emacs
     ide/energia
     ide/qtcreator
     ide/sublimetext

docs/ide/arduino.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -28,12 +28,21 @@ This software can be used with:
 Refer to the `Arduino Getting Started <http://arduino.cc/en/Guide/HomePage>`_
 page for Installation instructions.
 
+.. contents::
+
 Integration
 -----------
 
 More detailed information is located in PlatformIO blog:
 `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>`_.
 
+Articles / Manuals
+------------------
+
+* `Integration of PlatformIO library manager to Arduino and Energia IDEs <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_
+
+See the full list with :ref:`articles`.
+
 Screenshot
 ----------
 

docs/ide/atom.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -11,40 +11,180 @@
 
 .. _ide_atom:
 
-Atom
-====
+PlatformIO IDE for Atom
+=======================
 
-`Atom <https://atom.io>`_ is a text editor that's modern, approachable,
-yet hackable to the core—a tool you can customize to do anything but also use
-productively without ever touching a config file.
+PlatformIO IDE is the next generation integrated development environment for IoT:
 
-This software can be used with:
+* Cross-platform code builder without external dependencies to the system
+  software:
 
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
+    - 200+ embedded boards
+    - 15+ development platforms
+    - 10+ frameworks
+
+* C/C++ Intelligent code completion
+* C/C++ Smart code linter for super-fast coding
+* Library Manager for the hundreds popular libraries
+* Multi-projects workflow with multiple panes
+* Multiple panes
+* Themes support with dark and light colors
+* Serial Port Monitor
+* Built-in Terminal with :ref:`PlatformIO CLI <userguide>` tool (``pio``, ``platformio``)
+
+PlatformIO IDE is based on GitHub's `Atom <https://atom.io>`_ source
+code editor that's modern, approachable, yet hackable to the core; a tool you
+can customize to do anything but also use productively without ever touching a
+config file.
 
-Refer to the `Atom Documentation <https://atom.io/docs>`_
-page for more detailed information.
 
 .. contents::
 
-Integration
------------
+Installation
+------------
 
-Using `Atom Packages <https://atom.io/docs/v1.0.2/using-atom-atom-packages>`_
-please install `platomformio <https://atom.io/packages/platomformio>`_ package.
+1. Download and install Atom text editor
 
-Screenshot
+    - `Download for Mac <https://atom.io/download/mac>`_
+    - `Download for Windows <https://atom.io/download/windows>`_
+    - `Download .deb <https://atom.io/download/deb>`_
+    - `Download .rpm <https://atom.io/download/rpm>`_
+    - `Other platforms <https://github.com/atom/atom/releases/latest>`_
+
+
+2. Open Atom Package Manager and search for `platformio-ide <https://atom.io/packages/platformio-ide>`_
+
+    - **Mac OS X**: ``Menu: Atom > Preferences > Install``
+    - **Windows**: ``Menu: File > Settings > Install``
+    - **Linux**: ``Menu: Edit > Preferences > Install``
+
+.. image:: ../_static/ide-atom-platformio-install.png
+
+User Guide
 ----------
 
-Building
-^^^^^^^^
+.. image:: ../_static/ide-atom-platformio.png
+    :target: http://docs.platformio.org/en/latest/_images/ide-atom-platformio.png
 
-.. image:: ../_static/ide-platformio-atom-1.gif
-    :target: https://atom.io/packages/platomformio
+Menu item ``PlatformIO``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
-Uploading
-^^^^^^^^^
+`platformio-ide <https://atom.io/packages/platformio-ide>`_ package adds to Atom
+new menu item named ``Menu: PlatformIO`` (after ``Menu: Help`` item).
 
-.. image:: ../_static/ide-platformio-atom-2.gif
-    :target: https://atom.io/packages/platomformio
+.. image:: ../_static/ide-atom-platformio-menu-item.png
+
+PlatformIO Toolbar
+~~~~~~~~~~~~~~~~~~
+
+
+PlatformIO IDE Toolbar contains the quick access button to the popular commands.
+Each button contains hint (delay mouse on it).
+
+.. image:: ../_static/ide-atom-platformio-toolbar.png
+
+* PlatformIO: Build
+* PlatformIO: Upload
+* PlatformIO: Clean
+* Toggle build panel
+* ||
+* New File
+* Add/Open Project Folder...
+* Find in Project...
+* ||
+* Terminal
+* Serial Ports
+* Serial Monitor
+* ||
+* Settings
+* PlatformIO Documentation
+
+.. _ide_atom_quickstart:
+
+Quickstart
+~~~~~~~~~~
+
+:Step 1:
+
+    Create empty directory for the future project. Add it to PlatformIO IDE
+    using (folder) button on the Toolbar or ``Menu: File > Add Project
+    Folder...``
+
+:Step 2:
+
+    Initialize new PlatformIO based project using ``Menu: PlatformIO >
+    Initialize new Project (or update existing)`` and select boards.
+    Put your source code ``*.h, *.c, *.cpp, *.S, *.ino, etc``. files to ``src``
+    directory.
+
+:Step 3:
+
+    Process the project environments. More details :ref:`ide_atom_building_targets`.
+
+
+.. _ide_atom_building_targets:
+
+Building / Uploading / Targets
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ``cmd-alt-b`` / ``ctrl-alt-b`` / ``f9`` builds project without auto-uploading.
+* ``cmd-alt-u`` / ``ctrl-alt-u`` builds and uploads (if no errors).
+* ``cmd-alt-c`` / ``ctrl-alt-c`` cleans compiled objects.
+* ``cmd-alt-t`` / ``ctrl-alt-t`` / ``f7`` run other targets (Upload using Programmer, Upload SPIFFS image, Update platforms and libraries).
+* ``cmd-alt-g`` / ``ctrl-alt-g`` / ``f4`` cycles through causes of build error.
+* ``cmd-alt-h`` / ``ctrl-alt-h`` / ``shift-f4`` goes to the first build error.
+* ``cmd-alt-v`` / ``ctrl-alt-v`` / ``f8`` toggles the build panel.
+* ``escape`` terminates build / closes the build window.
+
+More details `Atom Build package <https://atom.io/packages/build>`_.
+
+Code completion
+~~~~~~~~~~~~~~~
+
+PlatformIO IDE uses `clang <http://clang.llvm.org>`_ for the code completion.
+To check that ``clang`` is available in your system, please open
+Terminal and run ``clang --version``. If ``clang`` is not installed, then install it:
+
+- **Mac OS X**: Install the latest Xcode along with the latest Command Line Tools
+  (they are installed automatically when you run ``clang`` in Terminal for the
+  first time, or manually by running ``xcode-select --install``
+- **Windows**: Download the latest `Clang for Windows <http://llvm.org/releases/download.html>`_.
+  Please select "Add LLVM to the system PATH" option on the installation step.
+- **Linux**: Using package managers: ``apt-get install clang`` or ``yum install clang``.
+- **Other Systems**: Download the latest `Clang for the other systems <http://llvm.org/releases/download.html>`_.
+
+.. warning::
+    The libraries which are added/installed after initializing process will
+    not be reflected in code linter. You need ``Menu: PlatformIO >
+    Rebuild C/C++ Project Index (Autocomplete, Linter)``.
+
+Code linter
+~~~~~~~~~~~
+
+PlatformIO IDE uses PlatformIO's pre-built GCC toolchains for code linting. The
+settings for Linter are located in ``.gcc-flags.json``. This file will be
+automatically created and preconfigured when you initialize project using
+``Menu: PlatformIO > Initialize new Project (or update existing)``.
+
+.. warning::
+    The libraries which are added/installed after initializing process will
+    not be reflected in code linter. You need ``Menu: PlatformIO >
+    Rebuild C/C++ Project Index (Autocomplete, Linter)``.
+
+
+.. error::
+    If you have error like ``linter-gcc: Executable not found`` and
+    ``"***/.platformio/packages/toolchain-atmelavr/bin/avr-g++" not found``
+    please ``Menu: PlatformIO > Initialize new Project (or update existing)``.
+
+Install Shell Commands
+~~~~~~~~~~~~~~~~~~~~~~
+
+To install ``platformio`` and ``pio`` shell commands please use ``Menu:
+PlatformIO > Install Shell Commands``. It will allow you to call PlatformIO from
+other process, terminal and etc.
+
+Known issues
+~~~~~~~~~~~~
+
+* Built-in Terminal doesn't support ``STDIN`` interaction

docs/ide/clion.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -33,29 +33,37 @@ page for more detailed information.
 Integration
 -----------
 
-Project Generator
-^^^^^^^^^^^^^^^^^
-
-Since PlatformIO 2.0 you can generate CLion compatible project using
-:option:`platformio init --ide` command. Please choose board type using
-:ref:`cmd_boards` command and run:
+Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+command and generate project via :option:`platformio init --ide` command:
 
 .. code-block:: shell
 
     platformio init --ide clion --board %TYPE%
 
+    # For example, generate project for Arduino UNO
+    platformio init --ide clion --board uno
+
 Then:
 
 1. Import this project via ``Menu: File > Import Project``
    and specify root directory where is located :ref:`projectconf`
 2. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
-3. Build project: ``Menu: Run > Build``.
+3. Build project (*DO NOT RUN*): ``Menu: Run > Build``.
 
-There are 3 predefined targets for building:
+There are 6 predefined targets for building (*NOT FOR RUNNING*, see marks on
+the screenshot below):
 
-* ``PLATFORMIO_BUILD`` - build project without auto-uploading
-* ``PLATFORMIO_UPLOAD`` - build and upload (if no errors)
-* ``PLATFORMIO_CLEAN`` - clean compiled objects and etc.
+* ``PLATFORMIO_BUILD`` - Build project without auto-uploading
+* ``PLATFORMIO_UPLOAD`` - Build and upload (if no errors).
+* ``PLATFORMIO_CLEAN`` - Clean compiled objects.
+* ``PLATFORMIO_PROGRAM`` - Build and upload using external programmer (if no errors), see :ref:`atmelavr_upload_via_programmer`.
+* ``PLATFORMIO_UPLOADFS`` - Upload files to file system SPIFFS, see :ref:`platform_espressif_uploadfs`.
+* ``PLATFORMIO_UPDATE`` - Update installed platforms and libraries via :ref:`cmd_update`.
+
+.. warning::
+    The libraries which are added, installed or used in the project
+    after generating process wont be reflected in IDE. To fix it you
+    need to reinitialize project using :ref:`cmd_init` (repeat it).
 
 .. warning::
     PlatformIO generates empty project by default and **code auto-completion
@@ -73,6 +81,15 @@ There are 3 predefined targets for building:
     Active discussion is located in
     `PlatformIO issue #132 <https://github.com/platformio/platformio/issues/132>`_.
 
+Articles / Manuals
+------------------
+
+* Dec 01, 2015 - **JetBrains CLion Blog** - `C++ Annotated: Fall 2015. Arduino Support in CLion using PlatformIO <http://blog.jetbrains.com/clion/2015/12/cpp-annotated-fall-2015/>`_
+* Nov 22, 2015 - **Michał Seroczyński** - `Using PlatformIO to get started with Arduino in CLion IDE <http://www.ches.pl/using-platformio-get-started-arduino-clion-ide/>`_
+* Nov 09, 2015 - **ÁLvaro García Gómez** - `Programar con Arduino "The good way" (Programming with Arduino "The good way", Spanish) <http://congdegnu.es/2015/11/09/programar-con-arduino-the-good-way/>`_
+
+See more :ref:`articles`.
+
 Screenshot
 ----------
 

docs/ide/eclipse.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -37,37 +37,58 @@ page for more detailed information.
 Integration
 -----------
 
-Project Generator
-^^^^^^^^^^^^^^^^^
-
-Since PlatformIO 2.0 you can generate Eclipse compatible project using
-:option:`platformio init --ide` command. Please choose board type using
-:ref:`cmd_boards` command and run:
+Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+command and generate project via :option:`platformio init --ide` command:
 
 .. code-block:: shell
 
     platformio init --ide eclipse --board %TYPE%
 
+    # For example, generate project for Arduino UNO
+    platformio init --ide eclipse --board uno
+
 Then:
 
 1. Import this project via
    ``Menu: File > Import... > General > Existing Projects into Workspace > Next``
    and specify root directory where is located :ref:`projectconf`
 2. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
-3. Build project: ``Menu: Project > Build Project``.
+3. Build project using ``Menu: Project > Build Project`` or preconfigured
+   Make Targets (see screenshot below):
 
+   + ``PlatformIO: Build`` - Build project without auto-uploading
+   + ``PlatformIO: Clean`` - Clean compiled objects.
+   + ``PlatformIO: Upload`` - Build and upload (if no errors)
+   + ``PlatformIO: Upload using Programmer`` see :ref:`atmelavr_upload_via_programmer`
+   + ``PlatformIO: Upload SPIFFS image`` see :ref:`platform_espressif_uploadfs`
+   + ``PlatformIO: Update platforms and libraries`` - Update installed platforms and libraries via :ref:`cmd_update`.
 
-Manual Integration
-^^^^^^^^^^^^^^^^^^
+If you have some problems with unresolved includes, defines, etc., then
 
-* `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>`_
-* `Improvised MBED FRDM-K64F Eclipse/PlatformIO Setup and Software Installation <http://thomasweldon.com/tpw/courses/embeddsp/p00pcFrdmK64_eclipsePlatformioSetup.html>`_
+* Restart Eclipse IDE
+* Rebuild index using ``Menu: Project > C/C++ Index > Rebuild``.
+
+.. warning::
+    The libraries which are added, installed or used in the project
+    after generating process wont be reflected in IDE. To fix it you
+    need to reinitialize project using :ref:`cmd_init` (repeat it).
+
+Articles / Manuals
+------------------
+
+* Sep 01, 2015 - **Thomas P. Weldon, Ph.D.** - `Improvised MBED FRDM-K64F Eclipse/PlatformIO Setup and Software Installation <http://thomasweldon.com/tpw/courses/embeddsp/p00pcFrdmK64_eclipsePlatformioSetup.html>`_
+* Jul 11, 2015 - **TrojanC** - `Learning Arduino GitHub Repository <http://www.trojanc.co.za/2015/07/11/learning-arduino-github-repository/>`_
+* June 20, 2014 - **Ivan Kravets, Ph.D.** - `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>`_
+
+See a full list with :ref:`articles`.
 
 Screenshot
 ----------
 
+Cross-platform `Blink Project <http://platformio.org/#!/get-started#blink-project-example>`_.
+
 .. 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
+    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-eclipse.png
 
 Examples
 --------

docs/ide/emacs.rst

@@ -0,0 +1,78 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+.. _ide_emacs:
+
+Emacs
+=====
+
+GNU Emacs is an extensible, customizable text editor - and more. At its core is
+an interpreter for Emacs Lisp, a dialect of the
+`Lisp programming language <http://en.wikipedia.org/wiki/Lisp_programming_language>`_
+with extensions to support text editing.
+
+
+This software can be used with:
+
+* all available :ref:`platforms`
+* all available :ref:`frameworks`
+
+Refer to the `Emacs Documentation <https://www.gnu.org/software/emacs/#Manuals>`_
+page for more detailed information.
+
+.. contents::
+
+Integration
+-----------
+
+PlatformIO-Mode
+^^^^^^^^^^^^^^^
+
+An Emacs minor mode has been written to facilitate building and uploading from within Emacs.
+It can be installed from the MELPA repository using ``M-x package-install``.
+See the MELPA `Getting Started <https://melpa.org/#/getting-started>`_ page for more information.
+
+Setup instructions and an example config can be found at the `Github page <https://github.com/ZachMassia/platformio-mode>`_.
+
+Code completion can optionally be provided by installing `irony-mode <https://github.com/Sarcasm/irony-mode>`_
+
+
+Project Generator
+^^^^^^^^^^^^^^^^^
+
+Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+command and generate project via :option:`platformio init --ide` command:
+
+.. code-block:: shell
+
+    platformio init --ide emacs --board %TYPE%
+
+
+There are 6 predefined targets for building.
+
+* ``platformio_build``  - Build project without auto-uploading.        (``C-c i b``)
+* ``platformio_clean``  - Clean compiled objects.                      (``C-c i c``)
+* ``platformio_upload`` - Build and upload (if no errors).             (``C-c i u``)
+* ``platformio_programmer_upload`` - Build and upload using external programmer (if no errors, see :ref:`atmelavr_upload_via_programmer`). (``C-c i p``)
+* ``platformio_spiffs_upload``  - Upload files to file system SPIFFS (see :ref:`platform_espressif_uploadfs`). (``C-c i s``)
+* ``platformio_update`` - Update installed platforms and libraries.    (``C-c i d``)
+
+.. warning::
+    The libraries which are added, installed or used in the project
+    after generating process wont be reflected in IDE. To fix it you
+    need to reinitialize project using :ref:`cmd_init` (repeat it).
+
+
+Screenshot
+----------
+
+.. image:: ../_static/ide-platformio-emacs.png
+    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-emacs.png

docs/ide/energia.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -28,12 +28,21 @@ This software can be used with:
 Refer to the `Energia Getting Started <http://energia.nu/guide/>`_
 page for Installation instructions.
 
+.. contents::
+
 Integration
 -----------
 
 More detailed information is located in PlatformIO blog:
 `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>`_.
 
+Articles / Manuals
+------------------
+
+* `Integration of PlatformIO library manager to Arduino and Energia IDEs <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_
+
+See the full list with :ref:`articles`.
+
 Screenshot
 -----------
 

docs/ide/qtcreator.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -37,14 +37,16 @@ Integration
 Project Generator
 ^^^^^^^^^^^^^^^^^
 
-Since PlatformIO 2.0 you can generate Qt Creator compatible project using
-:option:`platformio init --ide` command. Please choose board type using
-:ref:`cmd_boards` command and run:
+Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+command and generate project via :option:`platformio init --ide` command:
 
 .. code-block:: shell
 
     platformio init --ide qtcreator --board %TYPE%
 
+    # For example, generate project for Arduino UNO
+    platformio init --ide qtcreator --board uno
+
 Then:
 
 1. Import project via ``File > Open File or Project`` and select
@@ -85,6 +87,11 @@ Then:
 .. image:: ../_static/ide-platformio-qtcreator-3.png
     :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-3.png
 
+.. warning::
+    The libraries which are added, installed or used in the project
+    after generating process wont be reflected in IDE. To fix it you
+    need to reinitialize project using :ref:`cmd_init` (repeat it).
+
 Manual Integration
 ^^^^^^^^^^^^^^^^^^
 

docs/ide/sublimetext.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -32,14 +32,16 @@ Integration
 Project Generator
 ^^^^^^^^^^^^^^^^^
 
-Since PlatformIO 2.0 you can generate Sublime Text compatible project using
-:option:`platformio init --ide` command. Please choose board type using
-:ref:`cmd_boards` command and run:
+Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+command and generate project via :option:`platformio init --ide` command:
 
 .. code-block:: shell
 
     platformio init --ide sublimetext --board %TYPE%
 
+    # For example, generate project for Arduino UNO
+    platformio init --ide sublimetext --board uno
+
 Then:
 
 1. Import project via ``Menu: Project > Open Project...`` and select
@@ -48,6 +50,15 @@ Then:
 3. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
 4. Build project: ``Menu: Tools > Build``.
 
+Also, you can access to all pre-configured targets via
+``Menu: Tools > Builds With...`` (ST3)
+
++ ``PlatformIO - Build`` - Build project without auto-uploading
++ ``PlatformIO - Clean`` - Clean compiled objects.
++ ``PlatformIO - Upload`` - Build and upload (if no errors)
++ ``PlatformIO - Upload using Programmer`` see :ref:`atmelavr_upload_via_programmer`
++ ``PlatformIO - Upload SPIFFS image`` see :ref:`platform_espressif_uploadfs`
++ ``PlatformIO - Update platforms and libraries`` - Update installed platforms and libraries via :ref:`cmd_update`.
 
 Manual Integration
 ^^^^^^^^^^^^^^^^^^

docs/ide/vim.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -23,6 +23,8 @@ This software can be used with:
 * all available :ref:`platforms`
 * all available :ref:`frameworks`
 
+.. contents::
+
 Integration
 -----------
 
@@ -46,11 +48,33 @@ Put to the project directory ``Makefile`` wrapper with contents:
     #PATH := /usr/local/bin:$(PATH)
 
     all:
+        platformio -f -c vim run
+
+    upload:
         platformio -f -c vim run --target upload
 
     clean:
         platformio -f -c vim run --target clean
 
+    program:
+        platformio -f -c vim run --target program
+
+    uploadfs:
+        platformio -f -c vim run --target uploadfs
+
+    update:
+        platformio -f -c vim update
+
+
+Pre-defined targets:
+
++ ``Build`` - Build project without auto-uploading
++ ``Clean`` - Clean compiled objects.
++ ``Upload`` - Build and upload (if no errors)
++ ``Upload using Programmer`` see :ref:`atmelavr_upload_via_programmer`
++ ``Upload SPIFFS image`` see :ref:`platform_espressif_uploadfs`
++ ``Update platforms and libraries`` - Update installed platforms and libraries via :ref:`cmd_update`.
+
 
 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,
@@ -60,6 +84,13 @@ make firmware and upload it.
     If hotkey doesn't work for you, try to add this line
     ``nnoremap <C-b> :make<CR>`` to ``~/.vimrc``
 
+Articles / Manuals
+------------------
+
+* `コマンドラインでArduino開発 : vim + platformio (Arduino development at the command line: VIM + PlatformIO, Japanese) <http://qiita.com/caad1229/items/7b5fb47f034ae6e0baf2>`_
+
+See a full list with :ref:`articles`.
+
 Screenshot
 ----------
 

docs/ide/visualstudio.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -37,13 +37,15 @@ Integration
 Project Generator
 ^^^^^^^^^^^^^^^^^
 
-Since PlatformIO 2.0 you can generate Visual Studio compatible project using
-:option:`platformio init --ide` command. Please choose board type using
-:ref:`cmd_boards` command and run:
+Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+command and generate project via :option:`platformio init --ide` command:
 
 .. code-block:: shell
 
-    platformio init --ide visualstudio --board %TYPE%
+    platformio init --ide sublimetext --board %TYPE%
+
+    # For example, generate project for Arduino UNO
+    platformio init --ide visualstudio --board uno
 
 Then:
 
@@ -52,6 +54,11 @@ Then:
 2. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
 3. Build project: ``Menu: Build > Build Solution``.
 
+.. warning::
+    The libraries which are added, installed or used in the project
+    after generating process wont be reflected in IDE. To fix it you
+    need to reinitialize project using :ref:`cmd_init` (repeat it).
+
 Manual Integration
 ^^^^^^^^^^^^^^^^^^
 

docs/index.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -28,7 +28,7 @@ integration. Arduino and MBED compatible. Ready for Cloud compiling.**
 
 *Atmel AVR & SAM, Espressif, Freescale Kinetis, Nordic nRF51, NXP LPC,
 Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed,
-libOpenCM3, etc.**
+libOpenCM3, etc.*
 
 * `Website <http://platformio.org>`_
 * `Web 2.0 Library Search <http://platformio.org/#!/lib>`_ |
@@ -46,12 +46,12 @@ Embedded Development. *Easier Than Ever.*
 -----------------------------------------
 
 * Colourful command-line output
-* :ref:`IDE Integration <ide>` with *Arduino, Eclipse, Energia, Qt Creator,
-  Sublime Text, Vim, Visual Studio*
+* :ref:`IDE Integration <ide>` with *Arduino, Atom, CLion, Eclipse, Emacs,
+  Energia, Qt Creator, Sublime Text, Vim, Visual Studio*
 * Cloud compiling and  :ref:`ci` with *AppVeyor, Circle CI, Drone, Shippable, Travis CI*
 * Built-in :ref:`Serial Port Monitor <cmd_serialports_monitor>` and
   configurable build :ref:`-flags/-options <projectconf_build_flags>`
-* Pre-built tool chains, :ref:`frameworks` for the
+* Pre-built toolchains, :ref:`frameworks` for the
   :ref:`Development Platforms <platforms>`
 
 Smart Code Builder. *Fast and Reliable.*
@@ -71,7 +71,8 @@ The Missing Library Manager. *It's here!*
 * Automatic library updating
 * It runs on Windows, Mac OS X, and Linux (+ARM).
 
-For further details, please refer to :ref:`faq_what_is_platformio`
+For further details, please refer to
+:ref:`What is PlatformIO? How does it work? <faq_what_is_platformio>`
 
 Contents
 --------
@@ -94,16 +95,24 @@ Contents
 
 .. toctree::
     :caption: Instruments
-    :maxdepth: 2
+    :maxdepth: 3
 
     Platforms & Boards <platforms/index>
     frameworks/index
 
+.. toctree::
+    :caption: Library Manager
+    :maxdepth: 2
+
+    Quickstart <librarymanager/index>
+    User Guide <userguide/lib/index.rst>
+    librarymanager/config
+    librarymanager/creating
+
 .. toctree::
     :caption: Integration
     :maxdepth: 2
 
-    librarymanager/index
     ci/index
     ide
 

docs/installation.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -20,49 +20,55 @@ computers (`Raspberry Pi <http://www.raspberrypi.org>`_,
 `BeagleBone <http://beagleboard.org>`_,
 `CubieBoard <http://cubieboard.org>`_).
 
+.. note::
+    We are glad to announce official :ref:`ide_atom` which provides
+    comprehensive facilities for IoT development: built-in PlatformIO CLI tool,
+    Terminal and other instruments.
+
+    Try :ref:`ide_atom` for free now!
+
 .. contents::
 
 System requirements
 -------------------
 
-* **Operating systems:**
-    * Mac OS X
-    * Linux, +ARM
-    * Windows
-* Python 2.6.x or Python 2.7.x(recommended)
+:Operating System: Mac OS X, Linux (+ARM) or Windows
+:Python Interpreter:
 
-All commands below should be executed in
-`Command-line <http://en.wikipedia.org/wiki/Command-line_interface>`_
-application (Terminal):
+    Python 2.6 or 2.7. Python 2.7 is recommended
 
-* Mac OS X / Linux – *Terminal* application
-* Windows – ``cmd.exe`` application.
+    .. attention::
+        **Windows Users**: Please `Download the latest Python 2.7.x
+        <https://www.python.org/downloads/>`_ and install it.
+        **DON'T FORGET** to select ``Add python.exe to Path`` feature on the
+        "Customize" stage, otherwise ``pip`` command will not be available.
+
+:Terminal Application:
+
+    All commands below should be executed in
+    `Command-line <http://en.wikipedia.org/wiki/Command-line_interface>`_
+    application (Terminal). For Mac OS X and Linux OS - *Terminal* application,
+    for Windows OS – ``cmd.exe`` application.
 
 Installation Methods
 --------------------
 
-.. warning::
-    **Windows OS**: Please `Download the latest Python 2.7.x
-    <https://www.python.org/downloads/>`_ and install it.
-    **DON'T FORGET** to select ``Add python.exe to Path`` feature on the
-    "Customize" stage.
-
 Please *choose ONE of* the following methods:
 
 a) Python Package Manager
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The latest stable version of PlatformIO may be installed/upgraded via
-`pip <https://pip.pypa.io>`_ as follows:
+The latest stable version of PlatformIO may be installed or upgraded via
+Python Package Manager (`pip <https://pip.pypa.io>`_) as follows:
 
 .. code-block:: bash
 
-    # update dependent packages to the latest versions
-    pip install -U pip setuptools
-
-    # install/upgrade the latest version of PlatformIO
     pip install -U platformio
 
+If ``pip`` command is not available run ``easy_install pip`` or use
+:ref:`installation_installer_script` which will install ``pip`` and
+``platformio`` automatically.
+
 Note that you may run into permissions issues running these commands. You have
 a few options here:
 
@@ -132,7 +138,6 @@ c) Full Guide
 
 .. code-block:: bash
 
-    pip install -U pip setuptools
     pip install -U platformio
 
 If your computer does not recognize ``pip`` command, try to install it first
@@ -151,13 +156,24 @@ Install the latest PlatformIO from the ``develop`` branch:
 
 .. code-block:: bash
 
-    pip install -U pip setuptools
+    # uninstall existing version
+    pip uninstall platformio
+
+    # install the latest development version of PlatformIO
     pip install -U https://github.com/platformio/platformio/archive/develop.zip
 
 If you want to be up-to-date with the latest ``develop`` version of PlatformIO,
 then you need to re-install PlatformIO each time if you see the new commits in
 `PlatformIO GitHub repository (branch: develop) <https://github.com/platformio/platformio/commits/develop>`_.
 
+To revert to the latest stable version
+
+.. code-block:: bash
+
+    pip uninstall platformio
+    pip install -U platformio
+
+
 Troubleshooting
 ---------------
 

docs/librarymanager/config.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -15,11 +15,17 @@
 library.json
 ============
 
-``library.json`` is a manifest file of development library.
+``library.json`` is a manifest file of development library. It allows developers
+to keep project in own structure and define:
 
-Initially it was
-developed for :ref:`librarymanager`, but later was accepted by worldwide embedded
-community like a **standard library specification**.
+* location of source code
+* examples list
+* compatible frameworks and platforms
+* library dependencies
+
+PlatformIO Library Crawler uses ``library.json`` manifest to extract
+source code from developer's location and keeps cleaned library in own
+Library Storage.
 
 A data in ``library.json`` should be represented
 in `JSON-style <http://en.wikipedia.org/wiki/JSON>`_ via
@@ -132,7 +138,13 @@ Examples:
 
 *Required* if :ref:`libjson_downloadurl` field is not defined | Type: ``Object``
 
-The repository in which the source code can be found.
+The repository in which the source code can be found. The field consists for the
+next items:
+
+* ``type``
+* ``url``
+* ``branch`` if is not specified, default branch will be used. This field will
+  be ignored if tag/release exists with the value of :ref:`libjson_version`.
 
 Example:
 
@@ -144,6 +156,70 @@ Example:
         "url": "https://github.com/foo/bar.git"
     }
 
+.. _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.
+
+:Case 1:
+
+    :ref:`libjson_version` and :ref:`libjson_repository` fields are defined.
+    The :ref:`libjson_repository` is hosted on GitHub or Bitbucket.
+
+    |PIOAPICR| will lookup for release tag named as value of :ref:`libjson_version`
+    or with ``v`` prefix (you do not need to pass this ``v`` prefix to the
+    :ref:`libjson_version` field).
+
+:Case 2:
+
+    :ref:`libjson_version` and :ref:`libjson_repository` fields are defined
+    and :ref:`libjson_repository` does not contain tag/release with value of
+    :ref:`libjson_version`.
+
+    |PIOAPICR| will use the latest source code from :ref:`libjson_repository`
+    and link it with specified :ref:`libjson_version`. If :ref:`libjson_repository`
+    ``branch`` is not specified, then default branch will be used.
+    Also, if you push new commits to :ref:`libjson_repository`
+    and do not update :ref:`libjson_version` field, the library will not be
+    updated until you change the :ref:`libjson_version`.
+
+:Case 3:
+
+    :ref:`libjson_version` field is not defined and :ref:`libjson_repository`
+    field is defined.
+
+    |PIOAPICR| will use the
+    `CVS <http://en.wikipedia.org/wiki/Concurrent_Versions_System>`_ revision from
+    the latest commit as "current version". For example, ``13`` (*SVN*) or first
+    10 chars of *SHA* digest ``e4564b7da4`` (*Git*). If :ref:`libjson_repository`
+    ``branch`` is not specified, then default branch will be used.
+
+    We recommend to use :ref:`libjson_version` field and specify the real release
+    version and make appropriate target in the :ref:`libjson_repository`. In other
+    case, users will receive updates for library with each new commit to
+    :ref:`libjson_repository`.
+
+.. note::
+    |PIOAPICR| updates library only if:
+        - the :ref:`libjson_version` is changed
+        - ``library.json`` is modified
+
+Example:
+
+.. code-block:: javascript
+
+    "repository":
+    {
+        "type": "git",
+        "url": "https://github.com/foo/bar.git"
+    },
+    "version": "1.0.0"
 
 .. _libjson_downloadurl:
 
@@ -155,28 +231,20 @@ Example:
 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.
 
+    :ref:`libjson_downloadurl` has higher priority than
+    :ref:`libjson_repository`.
+
+Example with fixed release/tag on GitHub:
+
+.. code-block:: javascript
+
+    "version": "1.0.0",
+    "downloadUrl": "https://github.com/foo/bar/archive/v1.0.0.tar.gz",
+    "include": "bar-1.0.0"
+
+See more ``library.json`` :ref:`library_creating_examples`.
 
 .. _libjson_url:
 
@@ -238,6 +306,7 @@ Pattern	Meaning
     * - ``[!seq]``
       - matches any character not in seq
 
+See more ``library.json`` :ref:`library_creating_examples`.
 
 .. _libjson_exclude:
 
@@ -323,6 +392,8 @@ Example:
     ]
 
 
+See more ``library.json`` :ref:`library_creating_examples`.
+
 .. _libjson_examples:
 
 ``examples``
@@ -336,6 +407,9 @@ A list of example patterns. This field is predefined with default value:
 .. code-block:: javascript
 
     "examples": [
-        "[Ee]xamples/*/*.ini",
+        "[Ee]xamples/*/*.c",
+        "[Ee]xamples/*/*.cpp",
+        "[Ee]xamples/*/*.h",
+        "[Ee]xamples/*/*.ino",
         "[Ee]xamples/*/*.pde"
     ]

docs/librarymanager/creating.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -146,3 +146,12 @@ The registration requirements:
 Now, you can :ref:`register <cmd_lib_register>` your library and allow others
 to :ref:`install <cmd_lib_install>` it.
 
+
+.. _library_creating_examples:
+
+Examples
+--------
+
+* `GitHub + fixed release <http://platformio.org/#!/lib/show/552/ACNoblex>`_
+* `Dependencies by author and framework <http://platformio.org/#!/lib/show/3/PID-AutoTune>`_
+* `Multiple libraries in the one repository <https://github.com/jrowberg/i2cdevlib/tree/master/Arduino>`_

docs/librarymanager/index.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -14,10 +14,6 @@
 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
 
@@ -27,12 +23,4 @@ You can search for new libraries via
 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.com/>`_ and `bower
-    <http://bower.io>`_ package managers for web.
+.. image:: ../_static/platformio-demo-lib.gif

docs/platforms/atmelavr.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -82,6 +82,20 @@ Adafruit
       - Flash
       - RAM
 
+    * - ``bluefruitmicro``
+      - `Adafruit Bluefruit Micro <https://www.adafruit.com/products/2661>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``feather32u4``
+      - `Adafruit Feather <https://learn.adafruit.com/adafruit-feather-32u4-bluefruit-le/>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
     * - ``flora8``
       - `Adafruit Flora <http://www.adafruit.com/product/659>`_
       - ATMEGA32U4
@@ -96,6 +110,13 @@ Adafruit
       - 8 Kb
       - 0.5 Kb
 
+    * - ``metro``
+      - `Adafruit Metro <https://www.adafruit.com/products/2466>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
     * - ``protrinket3``
       - `Adafruit Pro Trinket 3V/12MHz (USB) <http://www.adafruit.com/products/2010>`_
       - ATMEGA328P
@@ -368,7 +389,7 @@ BQ
       - RAM
 
     * - ``zumbt328``
-      - `BQ ZUM BT-328 board <http://www.bq.com/gb/products/zum.html>`_
+      - `BQ ZUM BT-328 <http://www.bq.com/gb/products/zum.html>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
@@ -903,3 +924,5 @@ ubIQio
       - 16 MHz
       - 32 Kb
       - 2 Kb
+
+.. include:: atmelavr_extra.rst

docs/platforms/atmelavr_extra.rst

@@ -0,0 +1,115 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+.. _atmelavr_upload_via_programmer:
+
+Upload using Programmer
+-----------------------
+
+To upload firmware using programmer you need to use ``program`` target instead
+``upload`` for :option:`platformio run --target` command. For example,
+``platformio run -t program``.
+
+Configuration for the programmers:
+
+*   AVR ISP
+
+    .. code-block:: ini
+
+        [env:myenv]
+        platform = atmelavr
+        framework = arduino
+        upload_protocol = stk500v1
+        upload_flags = -P$UPLOAD_PORT
+
+        # edit this line with valid upload port
+        upload_port = SERIAL_PORT_HERE
+
+*   AVRISP mkII
+
+    .. code-block:: ini
+
+        [env:myenv]
+        platform = atmelavr
+        framework = arduino
+        upload_protocol = stk500v2
+        upload_flags = -Pusb
+
+*   USBtinyISP
+
+    .. code-block:: ini
+
+        [env:myenv]
+        platform = atmelavr
+        framework = arduino
+        upload_protocol = usbtiny
+
+*   USBasp
+
+    .. code-block:: ini
+
+        [env:myenv]
+        platform = atmelavr
+        framework = arduino
+        upload_protocol = usbasp
+        upload_flags = -Pusb
+
+*   Parallel Programmer
+
+    .. code-block:: ini
+
+        [env:myenv]
+        platform = atmelavr
+        framework = arduino
+        upload_protocol = dapa
+        upload_flags = -F
+
+*   Arduino as ISP
+
+    .. code-block:: ini
+
+        [env:myenv]
+        platform = atmelavr
+        framework = arduino
+        upload_protocol = stk500v1
+        upload_flags = -P$UPLOAD_PORT -b$UPLOAD_SPEED
+
+        # edit these lines
+        upload_port = SERIAL_PORT_HERE
+        upload_speed = 19200
+
+Articles
+--------
+
+* Dec 01, 2015 - **Michał Seroczyński** - `Push Notification from Arduino Yún with motion sensor <http://www.ches.pl/push-from-yun-1/>`_
+* Nov 29, 2015 - **Keith Hughes** - `Using PlatformIO for Embedded Projects <http://smartspacestuff.blogspot.com/2015/11/using-platformio-for-embedded-projects.html>`_
+* Nov 22, 2015 - **Michał Seroczyński** - `Using PlatformIO to get started with Arduino in CLion IDE <http://www.ches.pl/using-platformio-get-started-arduino-clion-ide/>`_
+* Nov 09, 2015 - **ÁLvaro García Gómez** - `Programar con Arduino "The good way" (Programming with Arduino "The good way", Spanish) <http://congdegnu.es/2015/11/09/programar-con-arduino-the-good-way/>`_
+* Oct 18, 2015 - **Nico Coetzee** - `First Arduino I2C Experience with PlatformIO <https://electronicventurer.wordpress.com/2015/10/18/first-arduino-i2c-experience/>`_
+* Oct 10, 2015 - **Floyd Hilton** - `Programming Arduino with Atom <http://floydhilton.com/software/career/2015/10/10/Arduino_with_Atom.html>`_
+* June 20, 2014 - **Ivan Kravets, Ph.D.** - `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>`_
+
+See more :ref:`articles`.
+
+Examples
+--------
+
+All project examples are located in PlatformIO repository
+`Examples for Atmel AVR platform <https://github.com/platformio/platformio/tree/develop/examples/atmelavr-and-arduino>`_.
+
+* `Wiring Blink <https://github.com/platformio/platformio/tree/develop/examples/wiring-blink>`_
+* `Arduino with external libraries <https://github.com/platformio/platformio/tree/develop/examples/atmelavr-and-arduino/arduino-external-libs>`_
+* `Arduino with internal libraries <https://github.com/platformio/platformio/tree/develop/examples/atmelavr-and-arduino/arduino-internal-libs>`_
+* `Project uses source file name for "src" directory (Arduino project structure) <https://github.com/platformio/platformio/tree/develop/examples/atmelavr-and-arduino/arduino-own-src_dir>`_
+* `Atmel AVR Native blink <https://github.com/platformio/platformio/tree/develop/examples/atmelavr-and-arduino/atmelavr-native-blink>`_
+* `Digitstump Mouse <https://github.com/platformio/platformio/tree/develop/examples/atmelavr-and-arduino/digitstump-mouse>`_
+* `Engduino magnetometer <https://github.com/platformio/platformio/tree/develop/examples/atmelavr-and-arduino/engduino-magnetometer>`_
+* `PanStamp blink <https://github.com/platformio/platformio/tree/develop/examples/atmelavr-and-arduino/panstamp-blink>`_

docs/platforms/atmelsam.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -28,15 +28,21 @@ Packages
     * - Name
       - Contents
 
+    * - ``toolchain-gccarmnoneeabi``
+      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded>`_, `GDB <http://www.gnu.org/software/gdb/>`_
+
     * - ``framework-arduinosam``
       - `Arduino Wiring-based Framework (SAM Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
 
+    * - ``tool-openocd``
+      - `OpenOCD <http://openocd.org>`_
+
+    * - ``framework-mbed``
+      - `mbed Framework <http://mbed.org>`_
+
     * - ``ldscripts``
       - `Linker Scripts <https://sourceware.org/binutils/docs/ld/Scripts.html>`_
 
-    * - ``toolchain-gccarmnoneeabi``
-      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded>`_, `GDB <http://www.gnu.org/software/gdb/>`_
-
     * - ``tool-bossac``
       - `BOSSA CLI <https://sourceforge.net/projects/b-o-s-s-a/>`_
 
@@ -60,6 +66,9 @@ Frameworks
     * - :ref:`framework_arduino`
       - Arduino Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
 
+    * - :ref:`framework_mbed`
+      - The mbed framework The mbed SDK has been designed to provide enough hardware abstraction to be intuitive and concise, yet powerful enough to build complex projects. It is built on the low-level ARM CMSIS APIs, allowing you to code down to the metal if needed. In addition to RTOS, USB and Networking libraries, a cookbook of hundreds of reusable peripheral and module libraries have been built on top of the SDK by the mbed Developer Community.
+
 Boards
 ------
 
@@ -84,18 +93,66 @@ Arduino
 
     * - ``due``
       - `Arduino Due (Programming Port) <http://arduino.cc/en/Main/arduinoBoardDue>`_
-      - AT91SAM3X8E
+      - SAM3X8E
       - 84 MHz
       - 512 Kb
       - 32 Kb
 
     * - ``dueUSB``
       - `Arduino Due (USB Native Port) <http://arduino.cc/en/Main/arduinoBoardDue>`_
-      - AT91SAM3X8E
+      - SAM3X8E
       - 84 MHz
       - 512 Kb
       - 32 Kb
 
+    * - ``zero``
+      - `Arduino Zero (Programming Port) <https://www.arduino.cc/en/Main/ArduinoBoardZero>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``zeroUSB``
+      - `Arduino Zero (USB Native Port) <https://www.arduino.cc/en/Main/ArduinoBoardZero>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+Atmel
+~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``samd21_xpro``
+      - `Atmel SAMD21-XPRO <https://developer.mbed.org/platforms/SAMD21-XPRO/>`_
+      - ATSAMD21J18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``saml21_xpro_b``
+      - `Atmel SAML21-XPRO-B <https://developer.mbed.org/platforms/SAML21-XPRO/>`_
+      - ATSAML21J18B
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``samr21_xpro``
+      - `Atmel ATSAMR21-XPRO <https://developer.mbed.org/platforms/SAMR21-XPRO/>`_
+      - ATSAMR21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
 Digistump
 ~~~~~~~~~
 

docs/platforms/creating_board.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/platforms/creating_platform.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -19,10 +19,10 @@ for the different development platforms via single command :ref:`cmd_run`
 without any dependent software or requirements.
 
 For this purpose *PlatformIO* uses own pre-configured platforms data:
-build scripts, tool chains, the settings for the most popular embedded
+build scripts, toolchains, the settings for the most popular embedded
 boards and etc. These data are pre-built and packaged to the different
 ``packages``. It allows *PlatformIO* to have multiple development platforms
-which can use the same packages(tool chains, frameworks), but have
+which can use the same packages(toolchains, frameworks), but have
 different/own build scripts, uploader and etc.
 
 .. note::
@@ -62,6 +62,9 @@ Packages
     * - ``framework-arduinomsp430``
       - `Arduino Wiring-based Framework (MSP430 Core) <http://arduino.cc/en/Reference/HomePage>`_
 
+    * - ``framework-arduinonordicnrf51``
+      - `Arduino Wiring-based Framework (RFduino Core) <https://github.com/RFduino/RFduino>`_
+
     * - ``framework-arduinosam``
       - `Arduino Wiring-based Framework (SAM Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
 
@@ -86,6 +89,9 @@ Packages
     * - ``framework-spl``
       - `Standard Peripheral Library for STM32 MCUs <http://www.st.com/web/catalog/tools/FM147/CL1794/SC961/SS1743/PF257890>`_
 
+    * - ``framework-wiringpi``
+      - `GPIO Interface library for the Raspberry Pi <http://wiringpi.com>`_
+
     * - ``ldscripts``
       - `Linker Scripts <https://sourceware.org/binutils/docs/ld/Scripts.html>`_
 
@@ -107,9 +113,21 @@ Packages
     * - ``tool-micronucleus``
       - `Micronucleus <https://github.com/micronucleus/micronucleus>`_
 
+    * - ``tool-mkspiffs``
+      - `Tool to build and unpack SPIFFS images <https://github.com/igrr/mkspiffs>`_
+
     * - ``tool-mspdebug``
       - `MSPDebug <http://mspdebug.sourceforge.net/>`_
 
+    * - ``tool-openocd``
+      - `OpenOCD <http://openocd.org>`_
+
+    * - ``tool-rfdloader``
+      - `rfdloader <https://github.com/RFduino/RFduino>`_
+
+    * - ``tool-scons``
+      - `SCons software construction tool <http://www.scons.org>`_
+
     * - ``tool-stlink``
       - `ST-Link <https://github.com/texane/stlink>`_
 
@@ -440,3 +458,4 @@ and copy there two files:
 
 Now, we should see ``ststm32gdb`` platform using :ref:`cmd_platforms_search` command output
 and can install it via :ref:`platformio platforms install ststm32gdb <cmd_platforms_install>` command.
+

docs/platforms/espressif.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -28,21 +28,24 @@ Packages
     * - Name
       - Contents
 
+    * - ``toolchain-xtensa``
+      - `xtensa-gcc <https://github.com/jcmvbkbc/gcc-xtensa>`_, `GDB <http://www.gnu.org/software/gdb/>`_
+
+    * - ``tool-esptool``
+      - `esptool-ck <https://github.com/igrr/esptool-ck>`_
+
+    * - ``tool-mkspiffs``
+      - `Tool to build and unpack SPIFFS images <https://github.com/igrr/mkspiffs>`_
+
+    * - ``framework-arduinoespressif``
+      - `Arduino Wiring-based Framework (ESP8266 Core) <https://github.com/esp8266/Arduino>`_
+
     * - ``ldscripts``
       - `Linker Scripts <https://sourceware.org/binutils/docs/ld/Scripts.html>`_
 
     * - ``sdk-esp8266``
       - `ESP8266 SDK <http://bbs.espressif.com>`_
 
-    * - ``tool-esptool``
-      - `esptool-ck <https://github.com/igrr/esptool-ck>`_
-
-    * - ``framework-arduinoespressif``
-      - `Arduino Wiring-based Framework (ESP8266 Core) <https://github.com/esp8266/Arduino>`_
-
-    * - ``toolchain-xtensa``
-      - `xtensa-gcc <https://github.com/jcmvbkbc/gcc-xtensa>`_, `GDB <http://www.gnu.org/software/gdb/>`_
-
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
     `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
@@ -72,6 +75,66 @@ Boards
     * For more detailed ``board`` information please scroll tables below by
       horizontal.
 
+Adafruit
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``huzzah``
+      - `Adafruit HUZZAH ESP8266 <https://www.adafruit.com/products/2471>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+Doit
+~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``espduino``
+      - `ESPDuino (ESP-13 Module) <https://www.tindie.com/products/doit/espduinowifi-uno-r3/>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+ESPino
+~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``espino``
+      - `ESPino <http://www.espino.io>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
 Espressif
 ~~~~~~~~~
 
@@ -86,15 +149,186 @@ Espressif
       - RAM
 
     * - ``esp01``
-      - `Espressif ESP8266 ESP-01 board <https://nurdspace.nl/ESP8266>`_
-      - ESP8266
-      - 40 MHz
-      - 512 Kb
-      - 32 Kb
-
-    * - ``esp12e``
-      - `Espressif ESP8266 ESP-12E board (NodeMCU) <https://nurdspace.nl/ESP8266>`_
+      - `Espressif Generic ESP8266 ESP-01 512k <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
       - ESP8266
       - 80 MHz
       - 512 Kb
-      - 32 Kb
+      - 80 Kb
+
+    * - ``esp01_1m``
+      - `Espressif Generic ESP8266 ESP-01 1M <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 1024 Kb
+      - 80 Kb
+
+    * - ``esp12e``
+      - `Espressif ESP8266 ESP-12E <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+    * - ``esp_wroom_02``
+      - `ESP-WROOM-02 <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 50 Kb
+
+    * - ``espresso_lite_v1``
+      - `ESPresso Lite 1.0 <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+    * - ``espresso_lite_v2``
+      - `ESPresso Lite 2.0 <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+NodeMCU
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``nodemcu``
+      - `NodeMCU 0.9 (ESP-12 Module) <http://www.nodemcu.com/>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+    * - ``nodemcuv2``
+      - `NodeMCU 1.0 (ESP-12E Module) <http://www.nodemcu.com/>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+Olimex
+~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``modwifi``
+      - `Olimex MOD-WIFI-ESP8266(-DEV) <https://www.olimex.com/Products/IoT/MOD-WIFI-ESP8266-DEV/open-source-hardware>`_
+      - ESP8266
+      - 80 MHz
+      - 2048 Kb
+      - 80 Kb
+
+SparkFun
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``thing``
+      - `SparkFun ESP8266 Thing <https://www.sparkfun.com/products/13231>`_
+      - ESP8266
+      - 80 MHz
+      - 512 Kb
+      - 80 Kb
+
+    * - ``thingdev``
+      - `SparkFun ESP8266 Thing Dev <https://www.sparkfun.com/products/13231>`_
+      - ESP8266
+      - 80 MHz
+      - 512 Kb
+      - 80 Kb
+
+SweetPea
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``esp210``
+      - `SweetPea ESP-210 <http://wiki.sweetpeas.se/index.php?title=ESP-210>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+ThaiEasyElec
+~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``espinotee``
+      - `ThaiEasyElec ESPino <http://www.thaieasyelec.com/products/wireless-modules/wifi-modules/espino-wifi-development-board-detail.html>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+WeMos
+~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``d1``
+      - `WeMos D1(Retired) <http://www.wemos.cc/wiki/doku.php?id=en:d1>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+    * - ``d1_mini``
+      - `WeMos D1 R2 & mini <http://www.wemos.cc/wiki/doku.php?id=en:d1_mini>`_
+      - ESP8266
+      - 80 MHz
+      - 4096 Kb
+      - 80 Kb
+
+.. include:: espressif_extra.rst

docs/platforms/espressif_extra.rst

@@ -0,0 +1,235 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+Custom CPU Frequency
+--------------------
+
+See :ref:`projectconf_board_f_cpu` option from :ref:`projectconf`
+
+.. code-block:: ini
+
+    [env:myenv]
+    # set frequency to 160MHz
+    board_f_cpu = 160000000L
+
+Custom FLASH Frequency
+----------------------
+
+See :ref:`projectconf_board_f_flash` option from :ref:`projectconf`. Possible
+values:
+
+* ``20000000L``
+* ``26000000L``
+* ``40000000L``
+* ``80000000L``
+
+.. code-block:: ini
+
+    [env:myenv]
+    # set frequency to 80MHz
+    board_f_flash = 80000000L
+
+Custom FLASH Mode
+-----------------
+
+Flash chip interface mode. This parameter is stored in the binary image
+header, along with the flash size and flash frequency. The ROM bootloader
+in the ESP chip uses the value of these parameters in order to know how to
+talk to the flash chip.
+
+See :ref:`projectconf_board_flash_mode` option from :ref:`projectconf`. Possible
+values:
+
+* ``qio``
+* ``qout``
+* ``dio``
+* ``dout``
+
+.. code-block:: ini
+
+    [env:myenv]
+    board_flash_mode = qio
+
+Custom Reset Method
+-------------------
+
+See :ref:`projectconf_upload_resetmethod` option from :ref:`projectconf`
+
+.. code-block:: ini
+
+    [env:myenv]
+    upload_resetmethod = ck
+
+.. _platform_espressif_customflash:
+
+Custom Flash Size
+-----------------
+
+.. warning::
+    Please make sure to read `ESP8266 Flash layout <https://github.com/esp8266/Arduino/blob/master/doc/filesystem.md#flash-layout>`_
+    information first.
+
+The list with preconfigured LD scripts is located in public repository
+`platformio-pkg-ldscripts <https://github.com/platformio/platformio-pkg-ldscripts>`_.
+
+* ``esp8266.flash.512k0.ld`` 512K (no SPIFFS)
+* ``esp8266.flash.512k64.ld`` 512K (64K SPIFFS)
+* ``esp8266.flash.1m64.ld`` 1M (64K SPIFFS)
+* ``esp8266.flash.1m128.ld`` 1M (128K SPIFFS)
+* ``esp8266.flash.1m256.ld`` 1M (256K SPIFFS)
+* ``esp8266.flash.1m512.ld`` 1M (512K SPIFFS)
+* ``esp8266.flash.2m.ld`` 2M (1M SPIFFS)
+* ``esp8266.flash.4m1m.ld`` 4M (1M SPIFFS)
+* ``esp8266.flash.4m.ld`` 4M (3M SPIFFS)
+
+To override default LD script please use :ref:`projectconf_build_flags` from
+:ref:`projectconf`.
+
+.. code-block:: ini
+
+    [env:myenv]
+    build_flags = -Wl,-Tesp8266.flash.4m.ld
+
+Custom Upload Speed
+-------------------
+
+See :ref:`projectconf_upload_speed` option from :ref:`projectconf`
+
+.. code-block:: ini
+
+    [env:myenv]
+    upload_speed = 9600
+
+.. _platform_espressif_uploadfs:
+
+Uploading files to file system SPIFFS
+-------------------------------------
+
+.. warning::
+    Please make sure to read `ESP8266 Flash layout <https://github.com/esp8266/Arduino/blob/master/doc/filesystem.md#flash-layout>`_
+    information first.
+
+1. Initialise project :ref:`cmd_init` (if you have not initialized yet)
+2. Create :ref:`projectconf_pio_data_dir` and put files here
+3. Run target ``uploadfs`` using  :option:`platformio run --target` command.
+
+To upload SPIFFS image using OTA update please specify ``upload_port`` /
+``--upload-port`` as IP address or mDNS host name (ending with the ``*.local``).
+For the details please follow to :ref:`platform_espressif_ota`.
+
+By default, will be used default LD Script for the board where is specified
+SPIFFS offsets (start, end, page, block). You can override it using
+:ref:`platform_espressif_customflash`.
+
+Active discussion is located in `issue #382 <https://github.com/platformio/platformio/issues/382>`_.
+
+.. _platform_espressif_ota:
+
+Over-the-Air (OTA) update
+-------------------------
+
+Firstly, please read `What is OTA? How to use it? <https://github.com/esp8266/Arduino/blob/master/doc/ota_updates/ota_updates.md>`_
+
+There are 2 options:
+
+* Directly specify :option:`platformio run --upload-port` in command line
+
+.. code-block:: bash
+
+    platformio run --target upload --upload-port IP_ADDRESS_HERE or mDNS_NAME.local
+
+* Specify ``upload_port`` option in :ref:`projectconf`
+
+.. code-block:: ini
+
+   [env:myenv]
+   upload_port = IP_ADDRESS_HERE or mDNS_NAME.local
+
+For example,
+
+* ``platformio run -t upload --upload-port 192.168.0.255``
+* ``platformio run -t upload --upload-port myesp8266.local``
+
+Authentication and upload options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can pass additional options/flags to OTA uploader using
+``upload_flags`` option in :ref:`projectconf`
+
+.. code-block:: ini
+
+    [env:myenv]
+    upload_flags = --port=8266
+
+Available flags
+
+* ``--port=ESP_PORT`` ESP8266 ota Port. Default 8266
+* ``--auth=AUTH`` Set authentication password
+* ``--spiffs`` Use this option to transmit a SPIFFS image and do not flash
+  the module
+
+For the full list with available options please run
+
+.. code-block:: bash
+
+    ~/.platformio/packages/framework-arduinoespressif/tools/espota.py -h
+
+    Usage: espota.py [options]
+
+    Transmit image over the air to the esp8266 module with OTA support.
+
+    Options:
+      -h, --help            show this help message and exit
+
+      Destination:
+        -i ESP_IP, --ip=ESP_IP
+                            ESP8266 IP Address.
+        -p ESP_PORT, --port=ESP_PORT
+                            ESP8266 ota Port. Default 8266
+
+      Authentication:
+        -a AUTH, --auth=AUTH
+                            Set authentication password.
+
+      Image:
+        -f FILE, --file=FILE
+                            Image file.
+        -s, --spiffs        Use this option to transmit a SPIFFS image and do not
+                            flash the module.
+
+      Output:
+        -d, --debug         Show debug output. And override loglevel with debug.
+        -r, --progress      Show progress output. Does not work for ArduinoIDE
+
+Demo
+~~~~
+
+.. image:: ../_static/platformio-demo-ota-esp8266.jpg
+    :target: https://www.youtube.com/watch?v=lXchL3hpDO4
+
+Articles
+--------
+
+* Jan 16, 2016 - **Dani Eichhorn** - `ESP8266 Arduino IDE Alternative: PlatformIO <http://blog.squix.ch/2016/01/esp8266-arduino-ide-alternative.html>`_
+* Dec 22, 2015 - **Jan Penninkhof** - `Over-the-Air ESP8266 programming using PlatformIO <http://www.penninkhof.com/2015/12/1610-over-the-air-esp8266-programming-using-platformio/>`_
+* Dec 01, 2015 - **Tateno Yuichi** - `ESP8266 を CUI で開発する (Develop a ESP8266 in CUI, Japanese) <http://jaywiggins.com/platformio/arduino/avr/es8266/2015/09/30/platformio-investigation/>`_
+
+See more :ref:`articles`.
+
+Examples
+--------
+
+All project examples are located in PlatformIO repository
+`Examples for Espressif platform <https://github.com/platformio/platformio/tree/develop/examples/espressif>`_.
+
+* `Native SDK <https://github.com/platformio/platformio/tree/develop/examples/espressif/esp8266-native>`_
+* `WebServer <https://github.com/platformio/platformio/tree/develop/examples/espressif/esp8266-webserver>`_
+* `WiFiScan <https://github.com/platformio/platformio/tree/develop/examples/espressif/esp8266-wifiscan>`_

docs/platforms/freescalekinetis.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/platforms/index.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/platforms/linux_arm.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -28,5 +28,62 @@ Packages
     * - Name
       - Contents
 
+    * - ``framework-wiringpi``
+      - `GPIO Interface library for the Raspberry Pi <http://wiringpi.com>`_
+
     * - ``toolchain-gccarmlinuxgnueabi``
-      - `GCC for Linux ARM GNU EABI <https://gcc.gnu.org>`_, `GDB <http://www.gnu.org/software/gdb/>`_
+      - `GCC for Linux ARM GNU EABI <https://gcc.gnu.org>`_, `GDB <http://www.gnu.org/software/gdb/>`_
+
+Frameworks
+----------
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Description
+
+    * - :ref:`framework_wiringpi`
+      - WiringPi is a GPIO access library written in C for the BCM2835 used in the Raspberry Pi. It's designed to be familiar to people who have used the Arduino "wiring" system.
+
+Boards
+------
+
+.. note::
+    * You can list pre-configured boards by :ref:`cmd_boards` command or
+      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
+    * For more detailed ``board`` information please scroll tables below by
+      horizontal.
+
+Raspberry Pi
+~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``raspberrypi_1b``
+      - `Raspberry Pi 1 Model B <https://www.raspberrypi.org>`_
+      - BCM2835
+      - 700 MHz
+      - 524288 Kb
+      - 524288 Kb
+
+    * - ``raspberrypi_2b``
+      - `Raspberry Pi 2 Model B <https://www.raspberrypi.org>`_
+      - BCM2836
+      - 900 MHz
+      - 1048576 Kb
+      - 1048576 Kb
+
+    * - ``raspberrypi_zero``
+      - `Raspberry Pi Zero <https://www.raspberrypi.org>`_
+      - BCM2835
+      - 1000 MHz
+      - 524288 Kb
+      - 524288 Kb

docs/platforms/linux_i686.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/platforms/linux_x86_64.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/platforms/native.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -13,7 +13,7 @@
 
 Platform ``native``
 ===================
-Native development platform is intended to be used for desktop OS. This platform uses built-in tool chains (preferable based on GCC), frameworks, libs from particular OS where it will be run.
+Native development platform is intended to be used for desktop OS. This platform uses built-in toolchains (preferable based on GCC), frameworks, libs from particular OS where it will be run.
 
 For more detailed information please visit `vendor site <http://platformio.org/#!/platforms/native>`_.
 

docs/platforms/nordicnrf51.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -31,9 +31,15 @@ Packages
     * - ``framework-mbed``
       - `mbed Framework <http://mbed.org>`_
 
+    * - ``tool-rfdloader``
+      - `rfdloader <https://github.com/RFduino/RFduino>`_
+
     * - ``toolchain-gccarmnoneeabi``
       - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded>`_, `GDB <http://www.gnu.org/software/gdb/>`_
 
+    * - ``framework-arduinonordicnrf51``
+      - `Arduino Wiring-based Framework (RFduino Core) <https://github.com/RFduino/RFduino>`_
+
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
     `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
@@ -51,6 +57,9 @@ Frameworks
     * - Name
       - Description
 
+    * - :ref:`framework_arduino`
+      - Arduino Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
+
     * - :ref:`framework_mbed`
       - The mbed framework The mbed SDK has been designed to provide enough hardware abstraction to be intuitive and concise, yet powerful enough to build complex projects. It is built on the low-level ARM CMSIS APIs, allowing you to code down to the metal if needed. In addition to RTOS, USB and Networking libraries, a cookbook of hundreds of reusable peripheral and module libraries have been built on top of the SDK by the mbed Developer Community.
 
@@ -137,6 +146,26 @@ Nordic
       - 128 Kb
       - 16 Kb
 
+RFduino
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``rfduino``
+      - `RFduino <http://www.rfduino.com/product/rfd22102-rfduino-dip/index.html>`_
+      - NRF51822
+      - 16 MHz
+      - 128 Kb
+      - 8 Kb
+
 RedBearLab
 ~~~~~~~~~~
 
@@ -203,3 +232,5 @@ Switch Science
       - 16 MHz
       - 256 Kb
       - 16 Kb
+
+.. include:: nordicnrf51_extra.rst

docs/platforms/nordicnrf51_extra.rst

@@ -0,0 +1,18 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+Examples
+--------
+
+All project examples are located in PlatformIO repository
+`Examples for Nordic nRF51 platform <https://github.com/platformio/platformio/tree/develop/examples/nordicnrf51>`_.
+
+* `RFduino iBeacon <https://github.com/platformio/platformio/tree/develop/examples/nordicnrf51/rfduino-ibeacon>`_

docs/platforms/nxplpc.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -169,7 +169,7 @@ NXP
       - LPC1768
       - 96 MHz
       - 512 Kb
-      - 32 Kb
+      - 64 Kb
 
 Outrageous Circuits
 ~~~~~~~~~~~~~~~~~~~
@@ -209,7 +209,7 @@ SeeedStudio
       - LPC1768
       - 96 MHz
       - 512 Kb
-      - 32 Kb
+      - 64 Kb
 
 Solder Splash Labs
 ~~~~~~~~~~~~~~~~~~
@@ -269,4 +269,4 @@ u-blox
       - LPC1768
       - 96 MHz
       - 512 Kb
-      - 32 Kb
+      - 64 Kb

docs/platforms/siliconlabsefm32.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/platforms/ststm32.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -183,6 +183,13 @@ ST
       - 2048 Kb
       - 256 Kb
 
+    * - ``disco_f469ni``
+      - `ST 32F469IDISCOVERY <http://www.st.com/web/catalog/tools/FM116/CL1620/SC959/SS1532/LN1848/PF262395>`_
+      - STM32F469NIH6
+      - 180 MHz
+      - 1024 Kb
+      - 384 Kb
+
     * - ``disco_l053c8``
       - `ST 32L0538DISCOVERY <http://www.st.com/web/en/catalog/tools/PF260319>`_
       - STM32L053C8T6
@@ -197,6 +204,13 @@ ST
       - 128 Kb
       - 16 Kb
 
+    * - ``disco_l476vg``
+      - `ST 32L476GDISCOVERY <http://www.st.com/web/catalog/tools/FM116/CL1620/SC959/SS1532/LN1848/PF261635>`_
+      - STM32L476VGT6
+      - 80 MHz
+      - 1024 Kb
+      - 128 Kb
+
     * - ``nucleo_f030r8``
       - `ST Nucleo F030R8 <https://developer.mbed.org/platforms/ST-Nucleo-F030R8/>`_
       - STM32F030R8T6
@@ -204,6 +218,20 @@ ST
       - 64 Kb
       - 8 Kb
 
+    * - ``nucleo_f031k6``
+      - `ST Nucleo F031K6 <https://developer.mbed.org/platforms/ST-Nucleo-F031K6/>`_
+      - STM32F031K6T6
+      - 48 MHz
+      - 32 Kb
+      - 4 Kb
+
+    * - ``nucleo_f042k6``
+      - `ST Nucleo F042K6 <https://developer.mbed.org/platforms/ST-Nucleo-F042K6/>`_
+      - STM32F042K6T6
+      - 48 MHz
+      - 32 Kb
+      - 6 Kb
+
     * - ``nucleo_f070rb``
       - `ST Nucleo F070RB <https://developer.mbed.org/platforms/ST-Nucleo-F070RB/>`_
       - STM32F070RBT6
@@ -239,6 +267,13 @@ ST
       - 64 Kb
       - 16 Kb
 
+    * - ``nucleo_f303k8``
+      - `ST Nucleo F303K8 <https://developer.mbed.org/platforms/ST-Nucleo-F303K8/>`_
+      - STM32F303K8T6
+      - 72 MHz
+      - 64 Kb
+      - 16 Kb
+
     * - ``nucleo_f303re``
       - `ST Nucleo F303RE <http://developer.mbed.org/platforms/ST-Nucleo-F303RE/>`_
       - STM32F303RET6
@@ -287,3 +322,12 @@ ST
       - 32 MHz
       - 512 Kb
       - 80 Kb
+
+    * - ``nucleo_l476rg``
+      - `ST Nucleo L476RG <https://developer.mbed.org/platforms/ST-Nucleo-L476RG/>`_
+      - STM32L476RGT6
+      - 80 MHz
+      - 1024 Kb
+      - 128 Kb
+
+.. include:: ststm32_extra.rst

docs/platforms/ststm32_extra.rst

@@ -0,0 +1,29 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+Articles
+--------
+
+* Nov 06, 2015 - **nocd5** - `PlatformIOでmbedをオフラインビルドしSTM32 Nucleoボードでmrubyを使う (Use mruby in the offline build for STM32 Nucleo board with mbed and PlatformIO, Japanese) <http://qiita.com/nocd5/items/d5fda776240f7e7c17eb>`_
+* Oct 21, 2015 - **Vittorio Zaccaria** - `Using a cheap STM32 Nucleo to teach remote sensor monitoring <http://www.vittoriozaccaria.net/blog/2015/10/21/using-a-cheap-stm32-nucleo-to-teach-remote-sensor-monitoring.html>`_
+* Aug 08, 2015 - **Josh Glendenning** - `Armstrap Eagle and PlatformIO <http://isobit.io/2015/08/08/armstrap.html>`_
+
+See more :ref:`articles`.
+
+Examples
+--------
+
+All project examples are located in PlatformIO repository
+`Examples for ST STM32 platform <https://github.com/platformio/platformio/tree/develop/examples/stm32>`_.
+
+* `CMSIS Blink <https://github.com/platformio/platformio/tree/develop/examples/stm32/stm32-cmsis-blink>`_
+* `libOpenCM3 Blink <https://github.com/platformio/platformio/tree/develop/examples/stm32/stm32-opencm3-blink>`_
+* `SPL Blink <https://github.com/platformio/platformio/tree/develop/examples/stm32/stm32-spl-blink>`_

docs/platforms/teensy.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -113,7 +113,7 @@ Teensy
       - 16 Kb
 
     * - ``teensy31``
-      - `Teensy 3.1 <https://www.pjrc.com/store/teensy31.html>`_
+      - `Teensy 3.1 / 3.2 <https://www.pjrc.com/store/teensy31.html>`_
       - MK20DX256
       - 72 MHz
       - 256 Kb

docs/platforms/timsp430.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -153,3 +153,5 @@ TI
       - 16 MHz
       - 16 Kb
       - 0.5 Kb
+
+.. include:: timsp430_extra.rst

docs/platforms/timsp430_extra.rst

@@ -0,0 +1,28 @@
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+Articles
+--------
+
+* Dec 08, 2015 - **Piotr Król** - `Using PlatformIO with TI MSP430 LunchPads <http://blog.3mdeb.com/2015/12/08/using-platformio-with-ti-msp430-lunchpads/>`_
+
+See more :ref:`articles`.
+
+Examples
+--------
+
+All project examples are located in PlatformIO repository
+`Examples for TI MSP430 platform <https://github.com/platformio/platformio/tree/develop/examples/timsp430>`_.
+
+* `PanStamp blink <https://github.com/platformio/platformio/tree/develop/examples/timsp430/panstamp-blink>`_
+* `Energia blink <https://github.com/platformio/platformio/tree/develop/examples/timsp430/timsp430-energia-blink>`_
+* `Native blink <https://github.com/platformio/platformio/tree/develop/examples/timsp430/timsp430-native-blink>`_
+* `Wiring Blink <https://github.com/platformio/platformio/tree/develop/examples/wiring-blink>`_

docs/platforms/titiva.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/platforms/windows_x86.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/projectconf.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -18,15 +18,15 @@ 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.
+key / value pairs within the sections. Lines beginning with ``#`` or ``;``
+are ignored and may be used to provide comments.
 
 The sections and their allowable values are described below.
 
 .. contents::
 
-[platformio]
-------------
+Section ``[platformio]``
+------------------------
 
 A ``platformio`` section is used for overriding default configuration options
 
@@ -44,7 +44,7 @@ Options
 ``home_dir``
 ^^^^^^^^^^^^
 
-Is used to store platform tool chains, frameworks, external libraries,
+Is used to store platform toolchains, frameworks, external libraries,
 service data and etc.
 
 A default value is User's home directory:
@@ -81,7 +81,8 @@ This option can be overridden by global environment variable
 A path to project's source directory. PlatformIO uses it for :ref:`cmd_run`
 command.
 
-A default value is ``%project_dir%/src``.
+A default value is ``src`` which means that folder is located in the root of
+project.
 
 This option can be overridden by global environment variable
 :envvar:`PLATFORMIO_SRC_DIR`.
@@ -105,7 +106,8 @@ fast!
 then PlatformIO will remove this folder automatically. It will be created on the
 next build operation.
 
-A default value is ``%project_dir%/.pioenvs``.
+A default value is ``.pioenvs`` which means that folder is located in the root of
+project.
 
 This option can be overridden by global environment variable
 :envvar:`PLATFORMIO_ENVS_DIR`.
@@ -115,9 +117,24 @@ This option can be overridden by global environment variable
     are defined in :ref:`projectconf`, then **TRY TO DELETE** this folder. In
     this situation you will remove all cached files without any risk.
 
-[env:NAME]
+.. _projectconf_pio_data_dir:
+
+``data_dir``
+^^^^^^^^^^^^
+
+Data directory to store contents and :ref:`platform_espressif_uploadfs`.
+
+A default value is ``data`` which means that folder is located in the root of
+project.
+
+This option can be overridden by global environment variable
+:envvar:`PLATFORMIO_DATA_DIR`.
+
 ----------
 
+Section ``[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.
@@ -130,8 +147,8 @@ Each environment must have unique ``NAME``. The valid chars for ``NAME`` are
 
 For example, ``[env:hello_world]``.
 
-Options
-~~~~~~~
+General options
+~~~~~~~~~~~~~~~
 
 .. _projectconf_env_platform:
 
@@ -150,7 +167,6 @@ Options
 
 The multiple frameworks are allowed, split them with comma ``,`` separator.
 
-
 .. _projectconf_env_board:
 
 ``board``
@@ -165,6 +181,9 @@ You can find the ``board`` type in *Boards* section of each :ref:`platforms` or
 using `PlatformIO Embedded Boards Explorer <http://platformio.org/#!/boards>`_.
 
 
+Board options
+~~~~~~~~~~~~~
+
 ``board_mcu``
 ^^^^^^^^^^^^^
 
@@ -176,6 +195,7 @@ is described `here <http://www.nongnu.org/avr-libc/user-manual/>`_.
 The full list of ``board_mcu`` for the popular embedded platforms you can find
 in *Boards* section of :ref:`platforms`. See "Microcontroller" column.
 
+.. _projectconf_board_f_cpu:
 
 ``board_f_cpu``
 ^^^^^^^^^^^^^^^
@@ -185,35 +205,31 @@ 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 the popular embedded platforms you can
-find in *Boards* section of :ref:`platforms`. See "Frequency" column.
+find in *Boards* section of :ref:`platforms`. See "Frequency" column. You can
+overclock a board by specifying a ``board_f_cpu`` value other than the default.
 
+.. _projectconf_board_f_flash:
 
-``upload_port``
-^^^^^^^^^^^^^^^
+``board_f_flash``
+^^^^^^^^^^^^^^^^^
 
-This option is used by "uploader" tool when sending firmware to board via
-``upload_port``. For example,
+An option ``board_f_flash`` is used to define FLASH chip 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 40 Mhz (Mega Hertz) is equal to ``40000000L``.
 
-* ``/dev/ttyUSB0`` - Unix-based OS
-* ``COM3`` - Windows OS
+This option isn't available for the all development platforms. The only
+:ref:`platform_espressif` supports it.
 
-If ``upload_port`` isn't specified, then *PlatformIO* will try to detect it
-automatically.
+.. _projectconf_board_flash_mode:
 
-To print all available serial ports use :ref:`cmd_serialports` command.
+``board_flash_mode``
+^^^^^^^^^^^^^^^^^^^^
 
+Flash chip interface mode. This option isn't available for the all development
+platforms. The only :ref:`platform_espressif` supports it.
 
-``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 board.
+Building options
+~~~~~~~~~~~~~~~~
 
 .. _projectconf_build_flags:
 
@@ -338,12 +354,140 @@ be applied in theirs order.
 `GLOB Patterns <http://en.wikipedia.org/wiki/Glob_(programming)>`_ are allowed.
 
 By default, ``src_filter`` is predefined to
-``+<*> -<.git/> -<svn/> -<examples/>``, which means "includes ALL files, then
-exclude ``.git`` and ``svn`` repository folders and exclude ``examples`` folder.
+``+<*> -<.git/> -<svn/> -<example/> -<examples/> -<test/> -<tests/>``,
+which means "includes ALL files, then
+exclude ``.git`` and ``svn`` repository folders, ``example`` ... folder.
 
 This option can be set by global environment variable
 :envvar:`PLATFORMIO_SRC_FILTER`.
 
+.. _projectconf_extra_script:
+
+``extra_script``
+^^^^^^^^^^^^^^^^
+
+Allows to launch extra script using `SCons <http://www.scons.org>`_ software
+construction tool. For more details please follow to "Construction Environments"
+section of
+`SCons documentation <http://www.scons.org/doc/production/HTML/scons-user.html#chap-environments>`_.
+
+This option can be set by global environment variable
+:envvar:`PLATFORMIO_EXTRA_SCRIPT`.
+
+Example, specify own upload command for :ref:`platform_atmelavr`:
+
+``platformio.ini``:
+
+.. code-block:: ini
+
+    [env:env_with_specific_extra_script]
+    platform = atmelavr
+    extra_script = /path/to/extra_script.py
+    custom_option = hello
+
+``extra_script.py``:
+
+.. code-block:: python
+
+    from SCons.Script import DefaultEnvironment
+
+    env = DefaultEnvironment()
+
+    env.Replace(UPLOADHEXCMD='"$UPLOADER" ${ARGUMENTS.get("custom_option")} --uploader --flags')
+
+    # uncomment line below to see environment variables
+    # print env.Dump()
+    # print ARGUMENTS
+
+
+* see built-in examples of `PlatformIO build scripts <https://github.com/platformio/platformio/tree/develop/platformio/builder/scripts>`_.
+* take a look at the multiple snippets/answers for the user questions:
+
+  - `#462 Split C/C++ build flags <https://github.com/platformio/platformio/issues/462#issuecomment-172667342>`_
+  - `#365 Extra configuration for ESP8266 uploader <https://github.com/platformio/platformio/issues/365#issuecomment-163695011>`_
+  - `#351 Specific reset method for ESP8266 <https://github.com/platformio/platformio/issues/351#issuecomment-161789165>`_
+  - `#247 Specific options for avrdude <https://github.com/platformio/platformio/issues/247#issuecomment-118169728>`_.
+
+``targets``
+^^^^^^^^^^^
+
+A list with targets which will be processed by :ref:`cmd_run` command by
+default. You can enter more than one target separated with "space".
+
+The list with available targets is located in :option:`platformio run --target`.
+
+**Tip!** You can use these targets like an option to
+:option:`platformio run --target` command. For example:
+
+.. code-block:: bash
+
+    # clean project
+    platformio run -t clean
+
+    # dump curent build environment
+    platformio run --target envdump
+
+When no targets are defined, *PlatformIO* will build only sources by default.
+
+
+Uploading options
+~~~~~~~~~~~~~~~~~
+
+.. _projectconf_upload_port:
+
+``upload_port``
+^^^^^^^^^^^^^^^
+
+This option is used by "uploader" tool when sending firmware to board via
+``upload_port``. For example,
+
+* ``/dev/ttyUSB0`` - Unix-based OS
+* ``COM3`` - Windows OS
+* ``192.168.0.13`` - IP address when using OTA
+
+If ``upload_port`` isn't specified, then *PlatformIO* will try to detect it
+automatically.
+
+To print all available serial ports use :ref:`cmd_serialports` command.
+
+This option can be set by global environment variable
+:envvar:`PLATFORMIO_UPLOAD_PORT`.
+
+``upload_protocol``
+^^^^^^^^^^^^^^^^^^^
+
+A protocol that "uploader" tool uses to talk to the board.
+
+.. _projectconf_upload_speed:
+
+``upload_speed``
+^^^^^^^^^^^^^^^^
+
+A connection speed (`baud rate <http://en.wikipedia.org/wiki/Baud>`_)
+which "uploader" tool uses when sending firmware to board.
+
+.. _projectconf_upload_flags:
+
+``upload_flags``
+^^^^^^^^^^^^^^^^
+
+Extra flags for uploader. Will be added to the end of uploader command. If you
+need to override uploader command or base flags please use :ref:`projectconf_extra_script`.
+
+This option can be set by global environment variable
+:envvar:`PLATFORMIO_UPLOAD_FLAGS`.
+
+.. _projectconf_upload_resetmethod:
+
+``upload_resetmethod``
+^^^^^^^^^^^^^^^^^^^^^^
+
+Specify reset method for "uploader" tool. This option isn't available for all
+development platforms. The only :ref:`platform_espressif` supports it.
+
+Library options
+~~~~~~~~~~~~~~~
+
 ``lib_install``
 ^^^^^^^^^^^^^^^
 
@@ -389,7 +533,7 @@ Example:
 ^^^^^^^^^^^^^^^^
 
 Control cyclic (recursive) behaviour for ``Library Dependency Finder (LDF)``.
-By default, this option is turned OFF (``lib_dfcyclic=False``) and means, that
+By default, this option is turned OFF (``lib_dfcyclic=False``) and means that
 ``LDF`` will find only libraries which are included in source files from the
 project :ref:`projectconf_pio_src_dir`.
 
@@ -404,63 +548,7 @@ Example:
     [env:libs_with_enabled_ldf_cyclic]
     lib_dfcyclic = True
 
-.. _projectconf_extra_script:
-
-``extra_script``
-^^^^^^^^^^^^^^^^
-
-Allows to launch extra script using `SCons <http://www.scons.org>`_ software
-construction tool. For more details please follow to "Construction Environments"
-section of
-`SCons documentation <http://www.scons.org/doc/production/HTML/scons-user.html#chap-environments>`_.
-
-This option can be set by global environment variable
-:envvar:`PLATFORMIO_EXTRA_SCRIPT`.
-
-Example, specify own upload command for :ref:`platform_atmelavr`:
-
-``platformio.ini``:
-
-.. code-block:: ini
-
-    [env:env_with_specific_extra_script]
-    platform = atmelavr
-    extra_script = /path/to/extra_script.py
-
-``extra_script.py``:
-
-.. code-block:: python
-
-    from SCons.Script import DefaultEnvironment
-
-    env = DefaultEnvironment()
-
-    env.Replace(UPLOADHEXCMD='"$UPLOADER" --uploader --flags')
-
-    # uncomment line below to see environment variables
-    # print env.Dump()
-
-See built-in examples of `PlatformIO build scripts <https://github.com/platformio/platformio/tree/develop/platformio/builder/scripts>`_.
-
-``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". Which
-targets are supported is described in :option:`platformio run --target`.
-
-**Tip!** You can use these targets like an option to
-:option:`platformio run --target` command. For example:
-
-.. code-block:: bash
-
-    # clean project
-    platformio run -t clean
-
-    # dump curent build environment
-    platformio run --target envdump
-
-When no targets are defined, *PlatformIO* will build only sources by default.
+-----------
 
 .. _projectconf_examples:
 
@@ -515,9 +603,11 @@ Examples
     platform = atmelavr
     framework = arduino
     board = pro8MHzatmega328
-    upload_protocol = usbasp -B5
+    upload_protocol = usbasp
+    upload_flags = -Pusb -B5
 
-Then upload firmware using :option:`platformio run --target program`
+Then upload firmware using target ``program`` for :option:`platformio run --target`.
+command. To use other programmers see :ref:`atmelavr_upload_via_programmer`.
 
 
 4. :ref:`platform_ststm32`: Upload firmware using GDB script ``upload.gdb``,

docs/quickstart.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -14,7 +14,7 @@
 Quickstart
 ==========
 
-.. note::
+.. hint::
     Please read `Get Started <http://platformio.org/#!/get-started>`_
     article from the official WebSite.
 
@@ -30,9 +30,6 @@ Quickstart
 
     $ platformio init --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
 
-    Would you like to enable firmware auto-uploading when project is successfully built using `platformio run` command?
-    Don't forget that you can upload firmware manually using `platformio run --target upload` command. [y/N]: y
-
     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.
@@ -66,10 +63,9 @@ Change working directory to the project's root where is located
     # 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 `PlatformIO Repository <https://github.com/platformio/platformio/tree/develop/examples>`_.
+Useful links:
 
-Also, for more detailed information as for commands please go to
-:ref:`userguide` sections.
+* `Project examples <https://github.com/platformio/platformio/tree/develop/examples>`_
+* :ref:`userguide` for PlatformIO commands
+* `Quickstart for Espressif ESP8266 <https://github.com/esp8266/Arduino/blob/master/doc/platformio.md>`_

docs/userguide/cmd_boards.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -21,23 +21,45 @@ Usage
 
 .. code-block:: bash
 
-    # Print all available pre-configured embedded boards
-    platformio boards
-
-    # Filter boards by "Query"
-    platformio boards QUERY
-
+    platformio boards [OPTIONS] [FILTER]
 
 Description
 -----------
 
 List pre-configured Embedded Boards
 
+Options
+~~~~~~~
+
+.. program:: platformio boards
+
+.. option::
+    --json-output
+
+Return the output in `JSON <http://en.wikipedia.org/wiki/JSON>`_ format
 
 Examples
 --------
 
-1. Show Arduino-based boards
+1. Show all available pre-configured embedded boards
+
+.. code-block:: bash
+
+    $ platformio boards
+
+    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. Filter Arduino-based boards
 
 .. code-block:: bash
 
@@ -56,7 +78,7 @@ Examples
     ...
 
 
-2. Show mbed-enabled boards
+3. Filter mbed-enabled boards
 
 .. code-block:: bash
 
@@ -95,7 +117,7 @@ Examples
     nucleo_f030r8         stm32f030r8t6  48Mhz     64Kb    8Kb    ST Nucleo F030R8
     ...
 
-3. Show boards which are based on ``ATmega168`` MCU
+4. Filter boards which are based on ``ATmega168`` MCU
 
 .. code-block:: bash
 
@@ -116,7 +138,7 @@ Examples
     168pa16m              atmega168p    16Mhz     15Kb    1Kb    Microduino Core (Atmega168PA@16M,5V)
     168pa8m               atmega168p    8Mhz      15Kb    1Kb    Microduino Core (Atmega168PA@8M,3.3V)
 
-4. Show boards by :ref:`platform_timsp430`
+5. Show boards by :ref:`platform_timsp430`
 
 .. code-block:: bash
 
@@ -133,4 +155,3 @@ Examples
     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_ci.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/cmd_init.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -27,7 +27,7 @@ Usage
 Description
 -----------
 
-Initialize new PlatformIO based project.
+Initialize new PlatformIO based project or update existing with new data.
 
 
 This command will create:
@@ -35,7 +35,8 @@ This command will create:
 * :ref:`projectconf`
 * ``src`` - a source directory. Put your source files here
 * ``lib`` - a directory for the project specific (private) libraries.
-  PlatformIO will compile them to static libraries and link to executable file
+* ``.travis.yml`` configuration file (template) for Continuous Integration
+  with :ref:`ci_travis`
 
 .. note::
     The source code of each library should be placed in separate directory.
@@ -71,15 +72,14 @@ Initialise PlatformIO project for the specified IDE which can be imported later
 via "Import Project" functionality.
 
 A list with supported IDE is available within ``platformio init --help`` command.
-Also, please look into :ref:`ide` page.
+Also, please take a look at :ref:`ide` page.
 
 .. option::
-    --disable-auto-uploading
+    --enable-auto-uploading
 
 If you initialise project with the specified
 :option:`platformio init --board`, then *PlatformIO*
-will create environment with enabled firmware auto-uploading. This option
-allows you to disable firmware auto-uploading by default.
+will create environment with enabled firmware auto-uploading.
 
 .. option::
     --env-prefix
@@ -138,9 +138,6 @@ Examples
 
     $ platformio init --board uno
 
-    Would you like to enable firmware auto-uploading when project is successfully built using `platformio run` command?
-    Don't forget that you can upload firmware manually using `platformio run --target upload` command. [y/N]: y
-
     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.

docs/userguide/cmd_run.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -53,6 +53,7 @@ Pre-built targets:
 * ``program`` firmware "auto-uploading" for embedded platforms using external
   programmer (available only for :ref:`platform_atmelavr`)
 * ``uploadlazy`` upload existing firmware without project rebuilding
+* ``uploadfs`` :ref:`platform_espressif_uploadfs`
 * ``envdump`` dump current build environment
 * ``size`` print the size of the sections in a firmware/program
 

docs/userguide/cmd_serialports.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -191,13 +191,16 @@ Do not apply any encodings/transformations
     --exit-char
 
 ASCII code of special character that is used to exit the application,
-default ``0x1d``
+default ``29`` (DEC).
+
+For example, to use ``Ctrl+Q`` run
+``platformio serialports monitor --exit-char 17``.
 
 .. option::
     --menu-char
 
 ASCII code of special character that is used to control miniterm (menu),
-default ``0x14``
+default ``20`` (DEC)
 
 .. option::
     ---quiet

docs/userguide/cmd_settings.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -113,8 +113,19 @@ Can PlatformIO communicate with you via prompts?
 :Default:   Yes
 :Values:    Yes/No
 
-Shares commands, platforms and libraries usage to help us make PlatformIO
-better.
+Share diagnostics and usage information to help us make PlatformIO better:
+
+* PlatformIO errors/exceptions
+* The name of used platforms, boards, frameworks (for example, "espressif", "arduino", "uno", etc.)
+* The name of commands (for example, "run", "lib list", etc.)
+* The type of IDE (for example, "atom", "eclipse", etc.)
+
+This gives us a sense of what parts of the PlatformIO is most important.
+
+The source code of telemetry service is `open source <https://github.com/platformio/platformio/blob/develop/platformio/telemetry.py>`_. You can make sure that we DO NOT share PRIVATE information or
+source code of your project. All information shares anonymously.
+
+Thanks a lot that keep this setting enabled.
 
 
 .. note::
@@ -137,8 +148,8 @@ Examples
     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)
-    enable_prompts                  Yes               Can PlatformIO communicate with you via prompts: propose to install platforms which aren't installed yet, paginate over library search results and etc.)? ATTENTION!!! If you call PlatformIO like subprocess, please disable prompts to avoid blocking (Yes/No)
-    enable_telemetry                Yes               Shares commands, platforms and libraries usage to help us make PlatformIO better (Yes/No)
+    enable_prompts                  Yes               Can PlatformIO communicate with you via prompts ...
+    enable_telemetry                Yes               Telemetry service (Yes/No)
 
 
 2. Show specified setting

docs/userguide/cmd_update.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/cmd_upgrade.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -36,7 +36,7 @@ Examples
 .. code-block:: bash
 
     $ platformio upgrade
-    You're up-to-date!
+    You are up-to-date!
     PlatformIO x.x.x is currently the newest version available.
 
     # If you have problem with permissions try:

docs/userguide/index.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at
@@ -22,6 +22,9 @@ Usage
 .. code-block:: bash
 
     platformio [OPTIONS] COMMAND
+    pio [OPTIONS] COMMAND
+
+    # "pio" is the alias of "platformio" command
 
 Options
 -------
@@ -59,7 +62,6 @@ Commands
     cmd_boards
     cmd_ci
     cmd_init
-    platformio lib <lib/index>
     platformio platforms <platforms/index>
     cmd_run
     cmd_serialports

docs/userguide/lib/cmd_install.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/lib/cmd_list.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/lib/cmd_register.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/lib/cmd_search.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/lib/cmd_show.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/lib/cmd_uninstall.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/lib/cmd_update.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/lib/index.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/platforms/cmd_install.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

docs/userguide/platforms/cmd_list.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at