Merge branch 'release/v3.0.1'

* develop: (21 commits)
  Use stable docs
  Version bump to 2.11.2 (issues #500, #533, #732, #731, #737, #733, #438, #722, #52, #725)
  Update project configuration template
  Use stable docs
  Implement firmware merging with base firmware for Nordic nRF51 development platform // Resolve #500 , Resolve #533
  Fix firmware uploading to Atmel SAMD21-XPRO board using ARM mbed framework // Resolve #732
  Add firmware merging process for nordicnrf51 // Issue #533, #500
  Add OpenOCD as an alternative upload method for atmelsam platform // Issue #732
  Sync flags parser with PlatformIO 3.0 branch // Resolve #738
  Update ``udev`` rules for the new STM32F407DISCOVERY boards // Resolve #731
  Add explanation about "Failed to find MSBuild toolsets directory"
  Add support for local "--echo" for Serial Port Monitor // Resolve #733
  Update history
  Improve support for Microchip PIC32 development platform and ChipKIT boards // Resolve #438
  Fix Project Generator for ESP8266 and ARM mbed based projects
  Switch to gcc-built LwIP library for espressif platform
  Push 2.11.2.dev2
  Fix linking process for microchippic32 platfrom // Issue #438
  Improve Project Generator for PlatformIO IDE (fixes incorrect linter errors)

.coveragerc

@@ -1,4 +1,4 @@
-# Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+# Copyright 2014-present PlatformIO <contact@platformio.org>
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -11,3 +11,16 @@
 # 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.
+
+[run]
+omit =
+	platformio/builder/*
+source = platformio
+
+[report]
+# Regexes for lines to exclude from consideration
+exclude_lines =
+    pragma: no cover
+    def __repr__
+    raise AssertionError
+    raise NotImplementedError

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,56 @@
+What kind of issue is this?
+
+- [ ] Question. This issue tracker is not the place for questions. If you want to ask how to do
+      something, or to understand why something isn't working the way you expect it to, use
+      our Community Forums https://community.platformio.org
+
+- [ ] PlatformIO IDE. All issues related to PlatformIO IDE should be reported to appropriate repository
+      https://github.com/platformio/platformio-atom-ide/issues
+
+- [ ] Development Platform. All issues related to Development Platform should be reported to appropriate repository. Search it using link below
+      https://github.com/platformio?query=platform-
+
+- [ ] Feature Request. Start by telling us what problem you’re trying to solve. Often a solution
+      already exists! Don’t send pull requests to implement new features without first getting our
+      support. Sometimes we leave features out on purpose to keep the project small.
+
+- [ ] PlatformIO Core. If you’ve found a bug, please provide an information below.
+
+*You can erase any parts of this template not applicable to your Issue.*
+
+------------------------------------------------------------------
+
+### Configuration
+
+**Operating system**:
+
+**PlatformIO Version** (`platformio --version`):
+
+### Description of problem
+
+
+#### Steps to Reproduce
+
+1.
+2.
+3.
+
+### Actual Results
+
+
+### Expected Results
+
+
+### If problems with PlatformIO Build System:
+
+**The content of `platformio.ini`:**
+```ini
+Insert here...
+```
+
+**Source file to reproduce issue:**
+```cpp
+Insert here...
+```
+
+### Additional info

.gitignore

@@ -5,3 +5,7 @@
 docs/_build
 dist
 build
+.cache
+coverage.xml
+.coverage
+htmlcov

.gitmodules

@@ -1,6 +1,3 @@
-[submodule "examples/atmelavr-and-arduino/arduino-external-libs/lib/Adafruit-PCD8544-Nokia-5110-LCD-library"]
-	path = examples/atmelavr-and-arduino/arduino-external-libs/lib/Adafruit-PCD8544-Nokia-5110-LCD-library
-	url = https://github.com/adafruit/Adafruit-PCD8544-Nokia-5110-LCD-library.git
-[submodule "examples/atmelavr-and-arduino/arduino-external-libs/lib/Adafruit-GFX-Library"]
-	path = examples/atmelavr-and-arduino/arduino-external-libs/lib/Adafruit-GFX-Library
-	url = https://github.com/adafruit/Adafruit-GFX-Library.git
+[submodule "examples"]
+	path = examples
+	url = https://github.com/platformio/platformio-examples.git

.isort.cfg

@@ -1,3 +1,3 @@
 [settings]
 line_length=79
-known_third_party=bottle,click,lockfile,pytest,requests,serial,SCons
+known_third_party=bottle,click,lockfile,pytest,requests,semantic_version,serial,SCons

.pylintrc

@@ -20,4 +20,4 @@ confidence=
 # --disable=W"
 # disable=import-star-module-level,old-octal-literal,oct-method,print-statement,unpacking-in-except,parameter-unpacking,backtick,old-raise-syntax,old-ne-operator,long-suffix,dict-view-method,dict-iter-method,metaclass-assignment,next-method-called,raising-string,indexing-exception,raw_input-builtin,long-builtin,file-builtin,execfile-builtin,coerce-builtin,cmp-builtin,buffer-builtin,basestring-builtin,apply-builtin,filter-builtin-not-iterating,using-cmp-argument,useless-suppression,range-builtin-not-iterating,suppressed-message,no-absolute-import,old-division,cmp-method,reload-builtin,zip-builtin-not-iterating,intern-builtin,unichr-builtin,reduce-builtin,standarderror-builtin,unicode-builtin,xrange-builtin,coerce-method,delslice-method,getslice-method,setslice-method,input-builtin,round-builtin,hex-method,nonzero-method,map-builtin-not-iterating
 
-disable=locally-disabled,missing-docstring,invalid-name,too-few-public-methods,redefined-variable-type,import-error,similarities,unsupported-membership-test,unsubscriptable-object,ungrouped-imports
+disable=locally-disabled,missing-docstring,invalid-name,too-few-public-methods,redefined-variable-type,import-error,similarities,unsupported-membership-test,unsubscriptable-object,ungrouped-imports,cyclic-import

.style.yapf

@@ -0,0 +1,3 @@
+[style]
+blank_line_before_nested_class_or_def = true
+allow_multiline_lambdas = true

.travis.yml

@@ -1,15 +1,42 @@
 language: python
-python:
-    - "2.7"
 
-env:
-    - TOX_ENV=docs
-    - TOX_ENV=lint
-    - TOX_ENV=py26
-    - TOX_ENV=py27
+matrix:
+  include:
+    - os: linux
+      sudo: false
+      python: 2.7
+      env: TOX_ENV=docs
+    - os: linux
+      sudo: false
+      python: 2.7
+      env: TOX_ENV=lint
+    - os: linux
+      sudo: required
+      python: 2.7
+      env: TOX_ENV=py27
+    - os: osx
+      language: generic
+      env: TOX_ENV=py27
 
 install:
-    - pip install -U pip setuptools tox
+  - git submodule update --init --recursive
+  - if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then sudo pip install -U tox; else pip install -U tox; fi
+
+  # temporary hook to fix issue with gcc-pic32
+  - if [[ "$TOX_ENV" == "py27" ]] && [[ "$TRAVIS_OS_NAME" == "linux" ]]; then sudo apt-get install -qq lib32z1 lib32ncurses5 lib32bz2-1.0; fi
 
 script:
-    - tox -e $TOX_ENV
+  - tox -e $TOX_ENV
+
+after_success:
+  - if [[ "$TOX_ENV" == "py27" ]] && [[ "$TRAVIS_OS_NAME" == "linux" ]]; then tox -e coverage; fi
+  - if [[ "$TOX_ENV" == "py27" ]] && [[ "$TRAVIS_OS_NAME" == "linux" ]]; then bash <(curl -s https://codecov.io/bash); fi
+
+notifications:
+  email: false
+
+  slack:
+    rooms:
+      secure: JD6VGfN4+SLU2CwDdiIOr1VgwD+zbYUCE/srwyGuHavnjIkPItkl6T6Bn8Y4VrU6ysbuKotfdV2TAJJ82ivFbY8BvZBc7FBcYp/AGQ4FaCCV5ySv8RDAcQgdE12oaGzMdODiLqsB85f65zOlAFa+htaXyEiRTcotn6Y2hupatrI=
+    on_failure: always
+    on_success: change

CONTRIBUTING.md

@@ -0,0 +1,21 @@
+Contributing
+------------
+
+To get started, <a href="https://www.clahub.com/agreements/platformio/platformio">sign the Contributor License Agreement</a>.
+
+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. Build documentation ``tox -e docs`` (creates a directory _build under docs where you can find the html)
+10. Commit changes to your forked repository
+11. Submit a Pull Request on GitHub.

HISTORY.rst

@@ -1,9 +1,450 @@
 Release Notes
 =============
 
+PlatformIO 3.0
+--------------
+
+3.0.1 (2016-09-08)
+~~~~~~~~~~~~~~~~~~
+
+* Disabled temporary SSL for PlatformIO services
+  (`issue #772 <https://github.com/platformio/platformio/issues/772>`_)
+
+3.0.0 (2016-09-07)
+~~~~~~~~~~~~~~~~~~
+
+* `PlatformIO Plus <https://pioplus.com>`__
+
+  + Local and Embedded `Unit Testing <http://docs.platformio.org/en/latest/unit_testing.html>`__
+    (`issue #408 <https://github.com/platformio/platformio/issues/408>`_,
+    `issue #519 <https://github.com/platformio/platformio/issues/519>`_)
+
+* Decentralized Development Platforms
+
+  + Development platform manifest "platform.json" and
+    `open source development platforms <https://github.com/platformio?utf8=✓&query=platform->`__
+  + `Semantic Versioning <http://semver.org/>`__ for platform commands,
+    development platforms and dependent packages
+  + Custom package repositories
+  + External embedded board configuration files, isolated build scripts
+    (`issue #479 <https://github.com/platformio/platformio/issues/479>`_)
+  + Embedded Board compatibility with more than one development platform
+    (`issue #456 <https://github.com/platformio/platformio/issues/456>`_)
+
+* Library Manager 3.0
+
+  + Project dependencies per build environment using `lib_deps <http://docs.platformio.org/en/latest/projectconf.html#lib-deps>`__ option
+    (`issue #413 <https://github.com/platformio/platformio/issues/413>`_)
+  + `Semantic Versioning <http://semver.org/>`__ for library commands and
+    dependencies
+    (`issue #410 <https://github.com/platformio/platformio/issues/410>`_)
+  + Multiple library storages: Project's Local, PlatformIO's Global or Custom
+    (`issue #475 <https://github.com/platformio/platformio/issues/475>`_)
+  + Install library by name
+    (`issue #414 <https://github.com/platformio/platformio/issues/414>`_)
+  + Depend on a library using VCS URL (GitHub, Git, ARM mbed code registry, Hg, SVN)
+    (`issue #498 <https://github.com/platformio/platformio/issues/498>`_)
+  + Strict search for library dependencies
+    (`issue #588 <https://github.com/platformio/platformio/issues/588>`_)
+  + Allowed ``library.json`` to specify sources other than PlatformIO's Repository
+    (`issue #461 <https://github.com/platformio/platformio/issues/461>`_)
+  + Search libraries by headers/includes with ``platformio lib search --header`` option
+
+* New Intelligent Library Build System
+
+  + `Library Dependency Finder <http://docs.platformio.org/en/latest/faq.html#how-works-library-dependency-finder-ldf>`__
+    that interprets C/C++ Preprocessor conditional macros with deep search behavior
+  + Check library compatibility with project environment before building
+    (`issue #415 <https://github.com/platformio/platformio/issues/415>`_)
+  + Control Library Dependency Finder for compatibility using
+    `lib_compat_mode <http://docs.platformio.org/en/latest/projectconf.html#lib-compat-mode>`__
+    option
+  + Custom library storages/directories with
+    `lib_extra_dirs <http://docs.platformio.org/en/latest/projectconf.html#lib-extra-dirs>`__ option
+    (`issue #537 <https://github.com/platformio/platformio/issues/537>`_)
+  + Handle extra build flags, source filters and build script from
+    `library.json <http://docs.platformio.org/en/latest/librarymanager/config.html>`__
+    (`issue #289 <https://github.com/platformio/platformio/issues/289>`_)
+  + Allowed to disable library archiving (``*.ar``)
+    (`issue #719 <https://github.com/platformio/platformio/issues/719>`_)
+  + Show detailed build information about dependent libraries
+    (`issue #617 <https://github.com/platformio/platformio/issues/617>`_)
+  + Support for the 3rd party manifests (Arduino IDE "library.properties"
+    and ARM mbed "module.json")
+
+* Removed ``enable_prompts`` setting. Now, all PlatformIO CLI is non-blocking!
+* Switched to SSL PlatformIO API
+* Renamed ``platformio serialports`` command to ``platformio device``
+* Build System: Attach custom Before/Pre and After/Post actions for targets
+  (`issue #542 <https://github.com/platformio/platformio/issues/542>`_)
+* Allowed passing custom project configuration options to ``platformio ci``
+  and ``platformio init`` commands using ``-O, --project-option``.
+* Print human-readable information when processing environments without
+  ``-v, --verbose`` option
+  (`issue #721 <https://github.com/platformio/platformio/issues/721>`_)
+* Improved INO to CPP converter
+  (`issue #659 <https://github.com/platformio/platformio/issues/659>`_,
+  `issue #765 <https://github.com/platformio/platformio/issues/765>`_)
+* Added ``license`` field to `library.json <http://docs.platformio.org/en/latest/librarymanager/config.html>`__
+  (`issue #522 <https://github.com/platformio/platformio/issues/522>`_)
+* Warn about unknown options in project configuration file ``platformio.ini``
+  (`issue #740 <https://github.com/platformio/platformio/issues/740>`_)
+* Fixed wrong line number for INO file when ``#warning`` directive is used
+  (`issue #742 <https://github.com/platformio/platformio/issues/742>`_)
+* Stopped supporting Python 2.6
+
+------
+
+* Development platform `Atmel SAM <https://github.com/platformio/platform-atmelsam>`__
+
+  + Fixed missing analog ports for Adafruit Feather M0 Bluefruit
+    (`issue #2 <https://github.com/platformio/platform-atmelsam/issues/2>`__)
+
+* Development platform `Nordic nRF51 <https://github.com/platformio/platform-nordicnrf51>`__
+
+  + Added support for BBC micro:bit board
+    (`issue #709 <https://github.com/platformio/platformio/issues/709>`_)
+
+* Development platform `ST STM32 <https://github.com/platformio/platform-ststm32>`__
+
+  + Added support for BluePill F103C8 board
+    (`pull #2 <https://github.com/platformio/platform-ststm32/pull/2>`__)
+
+* Development platform `Teensy <https://github.com/platformio/platform-teensy>`__
+
+  + Updated Arduino Framework to v1.29
+    (`issue #2 <https://github.com/platformio/platform-teensy/issues/2>`__)
+
+
 PlatformIO 2.0
 --------------
 
+2.11.2 (2016-08-02)
+~~~~~~~~~~~~~~~~~~~
+
+* Improved support for `Microchip PIC32 <http://docs.platformio.org/en/latest/platforms/microchippic32.html>`__ development platform and ChipKIT boards
+  (`issue #438 <https://github.com/platformio/platformio/issues/438>`_)
+* Added support for Pinoccio Scout board
+  (`issue #52 <https://github.com/platformio/platformio/issues/52>`_)
+* Added support for `Teensy USB Features <http://docs.platformio.org/en/latest/platforms/teensy.html#usb-features>`__
+  (HID, SERIAL_HID, DISK, DISK_SDFLASH, MIDI, etc.)
+  (`issue #722 <https://github.com/platformio/platformio/issues/722>`_)
+* Switched to built-in GCC LwIP library for Espressif development platform
+* Added support for local ``--echo`` for Serial Port Monitor
+  (`issue #733 <https://github.com/platformio/platformio/issues/733>`_)
+* Updated ``udev`` rules for the new STM32F407DISCOVERY boards
+  (`issue #731 <https://github.com/platformio/platformio/issues/731>`_)
+* Implemented firmware merging with base firmware for Nordic nRF51 development platform
+  (`issue #500 <https://github.com/platformio/platformio/issues/500>`_,
+  `issue #533 <https://github.com/platformio/platformio/issues/533>`_)
+* Fixed Project Generator for ESP8266 and ARM mbed based projects
+  (resolves incorrect linter errors)
+* Fixed broken LD Script for Element14 chipKIT Pi board
+  (`issue #725 <https://github.com/platformio/platformio/issues/725>`_)
+* Fixed firmware uploading to Atmel SAMD21-XPRO board using ARM mbed framework
+  (`issue #732 <https://github.com/platformio/platformio/issues/732>`_)
+
+2.11.1 (2016-07-12)
+~~~~~~~~~~~~~~~~~~~
+
+* Added support for Arduino M0, M0 Pro and Tian boards
+  (`issue #472 <https://github.com/platformio/platformio/issues/472>`_)
+* Added support for Microchip chipKIT Lenny board
+* Updated Microchip PIC32 Arduino framework to v1.2.1
+* Documented `uploading of EEPROM data <http://docs.platformio.org/en/latest/platforms/atmelavr.html#upload-eeprom-data>`__
+  (from EEMEM directive)
+* Added ``Rebuild C/C++ Project Index`` target to CLion and Eclipse IDEs
+* Improved project generator for `CLion IDE <http://docs.platformio.org/en/latest/ide/clion.html>`__
+* Added ``udev`` rules for OpenOCD CMSIS-DAP adapters
+  (`issue #718 <https://github.com/platformio/platformio/issues/718>`_)
+* Auto-remove project cache when PlatformIO is upgraded
+* Keep user changes for ``.gitignore`` file when re-generate/update project data
+* Ignore ``[platformio]`` section from custom project configuration file when
+  `platformio ci --project-conf <http://docs.platformio.org/en/latest/userguide/cmd_ci.html>`__
+  command is used
+* Fixed missed ``--boot`` flag for the firmware uploader for ATSAM3X8E
+  Cortex-M3 MCU based boards (Arduino Due, etc)
+  (`issue #710 <https://github.com/platformio/platformio/issues/710>`_)
+* Fixed missing trailing ``\`` for the source files list when generate project
+  for `Qt Creator IDE <http://docs.platformio.org/en/latest/ide/qtcreator.html>`__
+  (`issue #711 <https://github.com/platformio/platformio/issues/711>`_)
+* Split source files to ``HEADERS`` and ``SOURCES`` when generate project
+  for `Qt Creator IDE <http://docs.platformio.org/en/latest/ide/qtcreator.html>`__
+  (`issue #713 <https://github.com/platformio/platformio/issues/713>`_)
+
+2.11.0 (2016-06-28)
+~~~~~~~~~~~~~~~~~~~
+
+* New ESP8266-based boards: Generic ESP8285 Module, Phoenix 1.0 & 2.0, WifInfo
+* Added support for Arduino M0 Pro board
+  (`issue #472 <https://github.com/platformio/platformio/issues/472>`_)
+* Added support for Arduino MKR1000 board
+  (`issue #620 <https://github.com/platformio/platformio/issues/620>`_)
+* Added support for Adafruit Feather M0, SparkFun SAMD21 and SparkFun SAMD21
+  Mini Breakout boards
+  (`issue #520 <https://github.com/platformio/platformio/issues/520>`_)
+* Updated Arduino ESP8266 core for Espressif platform to 2.3.0
+* Better removing unnecessary flags using ``build_unflags`` option
+  (`issue #698 <https://github.com/platformio/platformio/issues/698>`_)
+* Fixed issue with ``platformio init --ide`` command for Python 2.6
+
+2.10.3 (2016-06-15)
+~~~~~~~~~~~~~~~~~~~
+
+* Fixed issue with ``platformio init --ide`` command
+
+2.10.2 (2016-06-15)
+~~~~~~~~~~~~~~~~~~~
+
+* Added support for ST Nucleo L031K6 board to ARM mbed framework
+* Process ``build_unflags`` option for ARM mbed framework
+* Updated Intel ARC32 Arduino framework to v1.0.6
+  (`issue #695 <https://github.com/platformio/platformio/issues/695>`_)
+* Improved a check of program size before uploading to the board
+* Fixed issue with ARM mbed framework ``-u _printf_float`` and
+  ``-u _scanf_float`` when parsing ``$LINKFLAGS``
+* Fixed issue with ARM mbed framework and extra includes for the custom boards,
+  such as Seeeduino Arch Pro
+
+2.10.1 (2016-06-13)
+~~~~~~~~~~~~~~~~~~~
+
+* Re-submit a package to PyPI
+
+2.10.0 (2016-06-13)
+~~~~~~~~~~~~~~~~~~~
+
+* Added support for `emonPi <https://github.com/openenergymonitor/emonpi>`__,
+  the OpenEnergyMonitor system
+  (`issue #687 <https://github.com/platformio/platformio/issues/687>`_)
+* Added support for `SPL <http://platformio.org/frameworks/spl>`__
+  framework for STM32F0 boards
+  (`issue #683 <https://github.com/platformio/platformio/issues/683>`_)
+* Added support for `Arduboy DevKit <https://www.arduboy.com>`__, the game system
+  the size of a credit card
+* Updated ARM mbed framework package to v121
+* Check program size before uploading to the board
+  (`issue #689 <https://github.com/platformio/platformio/issues/689>`_)
+* Improved firmware uploading to Arduino Leonardo based boards
+  (`issue #691 <https://github.com/platformio/platformio/issues/691>`_)
+* Fixed issue with ``-L relative/path`` when parsing ``build_flags``
+  (`issue #688 <https://github.com/platformio/platformio/issues/688>`_)
+
+2.9.4 (2016-06-04)
+~~~~~~~~~~~~~~~~~~
+
+* Show ``udev`` warning only for the Linux OS while uploading firmware
+
+2.9.3 (2016-06-03)
+~~~~~~~~~~~~~~~~~~
+
+* Added support for `Arduboy <https://www.arduboy.com>`__, the game system
+  the size of a credit card
+* Updated `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`__ for Linux OS
+* Refactored firmware uploading to the embedded boards with SAM-BA bootloader
+
+2.9.2 (2016-06-02)
+~~~~~~~~~~~~~~~~~~
+
+* Simplified `Continuous Integration with AppVeyor <http://docs.platformio.org/en/latest/ci/appveyor.html>`__
+  (`issue #671 <https://github.com/platformio/platformio/issues/671>`_)
+* Automatically add source directory to ``CPPPATH`` of Build System
+* Added support for Silicon Labs SLSTK3401A (Pearl Gecko) and
+  MultiTech mDot F411 ARM mbed based boards
+* Added support for MightyCore ATmega8535 board
+  (`issue #585 <https://github.com/platformio/platformio/issues/585>`_)
+* Added ``stlink`` as the default uploader for STM32 Discovery boards
+  (`issue #665 <https://github.com/platformio/platformio/issues/665>`_)
+* Use HTTP mirror for Package Manager in a case with SSL errors
+  (`issue #645 <https://github.com/platformio/platformio/issues/645>`_)
+* Improved firmware uploading to Arduino Leonardo/Due based boards
+* Fixed bug with ``env_default`` when ``pio run -e`` is used
+* Fixed issue with ``src_filter`` option for Windows OS
+  (`issue #652 <https://github.com/platformio/platformio/issues/652>`_)
+* Fixed configuration data for TI LaunchPads based on msp430fr4133 and
+  msp430fr6989 MCUs
+  (`issue #676 <https://github.com/platformio/platformio/issues/676>`_)
+* Fixed issue with ARM mbed framework and multiple definition errors
+  on FRDM-KL46Z board
+  (`issue #641 <https://github.com/platformio/platformio/issues/641>`_)
+* Fixed issue with ARM mbed framework when abstract class breaks compile
+  for LPC1768
+  (`issue #666 <https://github.com/platformio/platformio/issues/666>`_)
+
+2.9.1 (2016-04-30)
+~~~~~~~~~~~~~~~~~~
+
+* Handle prototype pointers while converting ``*.ino`` to ``.cpp``
+  (`issue #639 <https://github.com/platformio/platformio/issues/639>`_)
+
+2.9.0 (2016-04-28)
+~~~~~~~~~~~~~~~~~~
+
+* Project generator for `CodeBlocks IDE <http://docs.platformio.org/en/latest/ide/codeblocks.html>`__
+  (`issue #600 <https://github.com/platformio/platformio/issues/600>`_)
+* New `Lattice iCE40 FPGA <http://docs.platformio.org/en/latest/platforms/lattice_ice40.html>`__
+  development platform with support for Lattice iCEstick FPGA Evaluation
+  Kit and BQ IceZUM Alhambra FPGA
+  (`issue #480 <https://github.com/platformio/platformio/issues/480>`_)
+* New `Intel ARC 32-bit <http://docs.platformio.org/en/latest/platforms/intel_arc32.html>`_
+  development platform with support for Arduino/Genuino 101 board
+  (`issue #535 <https://github.com/platformio/platformio/issues/535>`_)
+* New `Microchip PIC32 <http://docs.platformio.org/en/latest/platforms/microchippic32.html>`__
+  development platform with support for 20+ different PIC32 based boards
+  (`issue #438 <https://github.com/platformio/platformio/issues/438>`_)
+* New RTOS and build Framework named `Simba <http://docs.platformio.org/en/latest/frameworks/simba.html>`__
+  (`issue #412 <https://github.com/platformio/platformio/issues/412>`_)
+* New boards for `ARM mbed <http://docs.platformio.org/en/latest/frameworks/mbed.html>`__
+  framework: ST Nucleo F410RB, ST Nucleo L073RZ and BBC micro:bit
+* Added support for Arduino.Org boards: Arduino Leonardo ETH, Arduino Yun Mini,
+  Arduino Industrial 101 and Linino One
+  (`issue #472 <https://github.com/platformio/platformio/issues/472>`_)
+* Added support for Generic ATTiny boards: ATTiny13, ATTiny24, ATTiny25,
+  ATTiny45 and ATTiny85
+  (`issue #636 <https://github.com/platformio/platformio/issues/636>`_)
+* Added support for MightyCore boards: ATmega1284, ATmega644, ATmega324,
+  ATmega164, ATmega32, ATmega16 and ATmega8535
+  (`issue #585 <https://github.com/platformio/platformio/issues/585>`_)
+* Added support for `TI MSP430 <http://docs.platformio.org/en/latest/platforms/timsp430.html>`__
+  boards: TI LaunchPad w/ msp430fr4133 and TI LaunchPad w/ msp430fr6989
+* Updated Arduino core for Espressif platform to 2.2.0
+  (`issue #627 <https://github.com/platformio/platformio/issues/627>`_)
+* Updated native SDK for ESP8266 to 1.5
+  (`issue #366 <https://github.com/platformio/platformio/issues/366>`_)
+* PlatformIO Library Registry in JSON format! Implemented
+  ``--json-output`` and ``--page`` options for
+  `platformio lib search <http://docs.platformio.org/en/latest/userguide/lib/cmd_search.html>`__
+  command
+  (`issue #604 <https://github.com/platformio/platformio/issues/604>`_)
+* Allowed to specify default environments `env_default <http://docs.platformio.org/en/latest/projectconf.html#env-default>`__
+  which should be processed by default with ``platformio run`` command
+  (`issue #576 <https://github.com/platformio/platformio/issues/576>`_)
+* Allowed to unflag(remove) base/initial flags using
+  `build_unflags <http://docs.platformio.org/en/latest/projectconf.html#build-unflags>`__
+  option
+  (`issue #559 <https://github.com/platformio/platformio/issues/559>`_)
+* Allowed multiple VID/PID pairs when detecting serial ports
+  (`issue #632 <https://github.com/platformio/platformio/issues/632>`_)
+* Automatically add ``-DUSB_MANUFACTURER`` with vendor's name
+  (`issue #631 <https://github.com/platformio/platformio/issues/631>`_)
+* Automatically reboot Teensy board after upload when Teensy Loader GUI is used
+  (`issue #609 <https://github.com/platformio/platformio/issues/609>`_)
+* Refactored source code converter from ``*.ino`` to ``*.cpp``
+  (`issue #610 <https://github.com/platformio/platformio/issues/610>`_)
+* Forced ``-std=gnu++11`` for Atmel SAM development platform
+  (`issue #601 <https://github.com/platformio/platformio/issues/601>`_)
+* Don't check OS type for ARM mbed-enabled boards and ST STM32 development
+  platform before uploading to disk
+  (`issue #596 <https://github.com/platformio/platformio/issues/596>`_)
+* Fixed broken compilation for Atmel SAMD based boards except Arduino Due
+  (`issue #598 <https://github.com/platformio/platformio/issues/598>`_)
+* Fixed firmware uploading using serial port with spaces in the path
+* Fixed cache system when project's root directory is used as ``src_dir``
+  (`issue #635 <https://github.com/platformio/platformio/issues/635>`_)
+
+2.8.6 (2016-03-22)
+~~~~~~~~~~~~~~~~~~
+
+* Launched `PlatformIO Community Forums <https://community.platformio.org>`_
+  (`issue #530 <https://github.com/platformio/platformio/issues/530>`_)
+* Added support for ARM mbed-enabled board Seed Arch Max (STM32F407VET6)
+  (`issue #572 <https://github.com/platformio/platformio/issues/572>`_)
+* Improved DNS lookup for PlatformIO API
+* Updated Arduino Wiring-based framework to the latest version for
+  Atmel AVR/SAM development platforms
+* Updated "Teensy Loader CLI" and fixed uploading of large .hex files
+  (`issue #568 <https://github.com/platformio/platformio/issues/568>`_)
+* Updated the support for Sanguino Boards
+  (`issue #586 <https://github.com/platformio/platformio/issues/586>`_)
+* Better handling of used boards when re-initialize/update project
+* Improved support for non-Unicode user profiles for Windows OS
+* Disabled progress bar for download operations when prompts are disabled
+* Fixed multiple definition errors for ST STM32 development platform and
+  ARM mbed framework
+  (`issue #571 <https://github.com/platformio/platformio/issues/571>`_)
+* Fixed invalid board parameters (reset method and baudrate) for a few
+  ESP8266 based boards
+* Fixed "KeyError: 'content-length'" in PlatformIO Download Manager
+  (`issue #591 <https://github.com/platformio/platformio/issues/591>`_)
+
+
+2.8.5 (2016-03-07)
+~~~~~~~~~~~~~~~~~~
+
+* Project generator for `NetBeans IDE <http://docs.platformio.org/en/latest/ide/netbeans.html>`__
+  (`issue #541 <https://github.com/platformio/platformio/issues/541>`_)
+* Created package for Homebrew Mac OS X Package Manager: ``brew install
+  platformio``
+  (`issue #395 <https://github.com/platformio/platformio/issues/395>`_)
+* Updated Arduino core for Espressif platform to 2.1.0
+  (`issue #544 <https://github.com/platformio/platformio/issues/544>`_)
+* Added support for the ESP8266 ESP-07 board to
+  `Espressif <http://docs.platformio.org/en/latest/platforms/espressif.html>`__
+  (`issue #527 <https://github.com/platformio/platformio/issues/527>`_)
+* Improved handling of String-based ``CPPDEFINES`` passed to extra ``build_flags``
+  (`issue #526 <https://github.com/platformio/platformio/issues/526>`_)
+* Generate appropriate project for CLion IDE and CVS
+  (`issue #523 <https://github.com/platformio/platformio/issues/523>`_)
+* Use ``src_dir`` directory from `Project Configuration File platformio.ini <http://docs.platformio.org/en/latest/projectconf.html>`__
+  when initializing project otherwise create base ``src`` directory
+  (`issue #536 <https://github.com/platformio/platformio/issues/536>`_)
+* Fixed issue with incorrect handling of user's build flags where the base flags
+  were passed after user's flags to GCC compiler
+  (`issue #528 <https://github.com/platformio/platformio/issues/528>`_)
+* Fixed issue with Project Generator when optional build flags were passed using
+  system environment variables: `PLATFORMIO_BUILD_FLAGS <http://docs.platformio.org/en/latest/envvars.html#platformio-build-flags>`__
+  or `PLATFORMIO_BUILD_SRC_FLAGS <http://docs.platformio.org/en/latest/envvars.html#platformio-build-src-flags>`__
+* Fixed invalid detecting of compiler type
+  (`issue #550 <https://github.com/platformio/platformio/issues/550>`_)
+* Fixed issue with updating package which was deleted manually by user
+  (`issue #555 <https://github.com/platformio/platformio/issues/555>`_)
+* Fixed incorrect parsing of GCC ``-include`` flag
+  (`issue #552 <https://github.com/platformio/platformio/issues/552>`_)
+
+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>`_
+  (`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)
 ~~~~~~~~~~~~~~~~~~
 
@@ -20,7 +461,7 @@ PlatformIO 2.0
 * 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>`__
-  and allowed to `change default upload reset method <http://docs.platformio.org/en/latest/platforms/espressif.html#custom-reset-method>`_
+  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
@@ -467,12 +908,12 @@ PlatformIO 1.0
 1.5.0 (2015-05-15)
 ~~~~~~~~~~~~~~~~~~
 
-* Added support of `Framework mbed <http://platformio.org/#!/frameworks/mbed>`_
+* Added support of `Framework mbed <http://platformio.org/frameworks/mbed>`_
   for Teensy 3.1
   (`issue #183 <https://github.com/platformio/platformio/issues/183>`_)
 * Added GDB as alternative uploader to `ststm32 <http://docs.platformio.org/en/latest/platforms/ststm32.html>`__ platform
   (`issue #175 <https://github.com/platformio/platformio/issues/174>`_)
-* Added `examples <https://github.com/platformio/platformio/tree/develop/examples>`__
+* Added `examples <https://github.com/platformio/platformio-examples/tree/develop>`__
   with preconfigured IDE projects
   (`issue #154 <https://github.com/platformio/platformio/issues/154>`_)
 * Fixed firmware uploading under Linux OS for Arduino Leonardo board
@@ -554,7 +995,7 @@ PlatformIO 1.0
 * Created new `Frameworks <http://docs.platformio.org/en/latest/frameworks/index.html>`__
   page in documentation and added to `PlatformIO Web Site <http://platformio.org>`_
   (`issue #115 <https://github.com/platformio/platformio/issues/115>`_)
-* Introduced online `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+* Introduced online `Embedded Boards Explorer <http://platformio.org/boards>`_
 * Automatically append define ``-DPLATFORMIO=%version%`` to
   builder (`issue #105 <https://github.com/platformio/platformio/issues/105>`_)
 * Renamed ``stm32`` development platform to
@@ -703,8 +1144,7 @@ PlatformIO 0.0
 ~~~~~~~~~~~~~~~~~~
 
 * Replaced "dark blue" by "cyan" colour for the texts (`issue #33 <https://github.com/platformio/platformio/issues/33>`_)
-* Added new setting `enable_prompts <http://docs.platformio.org/en/latest/userguide/cmd_settings.html>`_
-  and allowed to disable all *PlatformIO* prompts (useful for cloud compilers)
+* Added new setting ``enable_prompts`` and allowed to disable all *PlatformIO* prompts (useful for cloud compilers)
   (`issue #34 <https://github.com/platformio/platformio/issues/34>`_)
 * Fixed compilation bug on *Windows* with installed *MSVC* (`issue #18 <https://github.com/platformio/platformio/issues/18>`_)
 
@@ -718,9 +1158,9 @@ PlatformIO 0.0
 * Fixed "*OSError: [Errno 2] No such file or directory*" within
   `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
   command when PlatformIO isn't installed properly
-* Fixed example for `Eclipse IDE with Tiva board <https://github.com/platformio/platformio/tree/develop/examples/ide/eclipse>`_
+* Fixed example for `Eclipse IDE with Tiva board <https://github.com/platformio/platformio-examples/tree/develop/ide/eclipse>`_
   (`issue #32 <https://github.com/platformio/platformio/pull/32>`_)
-* Upgraded `Eclipse Project Examples <https://github.com/platformio/platformio/tree/develop/examples/ide/eclipse>`_
+* Upgraded `Eclipse Project Examples <https://github.com/platformio/platformio-examples/tree/develop/ide/eclipse>`_
   to latest *Luna* and *PlatformIO* releases
 
 0.9.0 (2014-12-01)
@@ -788,7 +1228,7 @@ PlatformIO 0.0
 * Disabled default warning flag "-Wall"
 * Added auto-conversation from \*.ino to valid \*.cpp for Arduino/Energia
   frameworks (`issue #7 <https://github.com/platformio/platformio/issues/7>`_)
-* Added `Arduino example <https://github.com/platformio/platformio/tree/develop/examples/>`_
+* Added `Arduino example <https://github.com/platformio/platformio-examples/tree/develop/>`_
   with external library (*Adafruit CC3000*)
 * Implemented `platformio upgrade <http://docs.platformio.org/en/latest/userguide/cmd_upgrade.html>`_
   command and "auto-check" for the latest
@@ -837,7 +1277,7 @@ PlatformIO 0.0
 
 * Resolved `issue #1 "Build referred libraries" <https://github.com/platformio/platformio/issues/1>`_
 * Renamed project's "libs" directory to "lib"
-* Added `arduino-internal-library <https://github.com/platformio/platformio/tree/develop/examples/>`_ example
+* Added `arduino-internal-library <https://github.com/platformio/platformio-examples/tree/develop/>`_ example
 * Changed to beta status
 
 

Makefile

@@ -0,0 +1,23 @@
+
+lint:
+	pylint --rcfile=./.pylintrc ./platformio
+
+isort:
+	isort -rc ./platformio
+	isort -rc ./tests
+
+yapf:
+	yapf --recursive --in-place platformio/
+
+before-commit: isort yapf lint
+
+clean-docs:
+	rm -rf docs/_build
+
+clean: clean-docs
+	find . -name \*.pyc -delete
+	find . -name __pycache__ -delete
+	rm -rf .cache
+	rm -rf build
+	rm -rf htmlcov
+	rm -f .coverage

README.rst

@@ -7,9 +7,8 @@ PlatformIO
 .. image:: https://ci.appveyor.com/api/projects/status/dku0h2rutfj0ctls/branch/develop?svg=true
     :target: https://ci.appveyor.com/project/ivankravets/platformio
     :alt: AppVeyor.CI Build Status
-.. image:: https://circleci.com/gh/platformio/platformio/tree/develop.svg?style=svg
-    :target: https://circleci.com/gh/platformio/platformio/tree/develop
-    :alt: Circle.CI Build Status
+.. image:: https://codecov.io/gh/platformio/platformio/branch/develop/graph/badge.svg
+  :target: https://codecov.io/gh/platformio/platformio
 .. image:: https://requires.io/github/platformio/platformio/requirements.svg?branch=develop
     :target: https://requires.io/github/platformio/platformio/requirements/?branch=develop
     :alt: Requirements Status
@@ -19,37 +18,39 @@ PlatformIO
 .. image:: https://img.shields.io/pypi/l/platformio.svg
     :target: https://pypi.python.org/pypi/platformio/
     :alt:  License
-.. image:: https://img.shields.io/pypi/dm/platformio.svg
-    :target: https://pypi.python.org/pypi/platformio/
-    :alt: PyPi Downloads
-.. image:: https://img.shields.io/sourceforge/dm/platformio-storage.svg
-    :target: https://sourceforge.net/projects/platformio-storage/
-    :alt: Packages Downloads
-.. 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: https://www.liqpay.com/api/3/checkout?data=eyJ2ZXJzaW9uIjozLCJhY3Rpb24iOiJwYXlkb25hdGUiLCJwdWJsaWNfa2V5IjoiaTc0NzkxMDA2NjIxIiwiYW1vdW50IjoiMSIsImN1cnJlbmN5IjoiVVNEIiwiZGVzY3JpcHRpb24iOiJEb25hdGlvbiBmb3IgUGxhdGZvcm1JTy5PcmciLCJ0eXBlIjoiZG9uYXRlIiwibGFuZ3VhZ2UiOiJlbiJ9&signature=XYvETjqlpoFhoFtxUJlF6hQyS7Y%3D
+.. image:: https://img.shields.io/community/PlatformIO.png
+   :alt: Community Forums
+   :target: https://community.platformio.org
+.. image:: https://img.shields.io/PlatformIO/Plus.png?color=orange
+   :alt: PlatformIO Plus: Professional solutions for an awesome open source PlatformIO ecosystem
+   :target: https://pioplus.com
 
+**Quick Links:** `Home Page <http://platformio.org>`_ |
+`PlatformIO Plus <https://pioplus.com>`_ |
+`PlatformIO IDE <http://platformio.org/platformio-ide>`_ |
+`Project Examples <https://github.com/platformio/platformio-examples/tree/develop>`_ |
+`Docs <http://docs.platformio.org>`_ |
+`Donate <http://platformio.org/donate>`_ |
+`Contact Us <http://platformio.org/contact>`_
 
-`Home & Demo <http://platformio.org>`_ |
-`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>`_ |
-`Twitter <https://twitter.com/PlatformIO_Org>`_ |
-`Hackaday <https://hackaday.io/project/7980-platformio>`_ |
+**Social:** `Twitter <https://twitter.com/PlatformIO_Org>`_ |
 `Facebook <https://www.facebook.com/platformio>`_ |
-`Reddit <http://www.reddit.com/r/platformio/>`_
+`Hackaday <https://hackaday.io/project/7980-platformio>`_ |
+`Bintray <https://bintray.com/platformio>`_ |
+`Community <https://community.platformio.org>`_ |
 
 .. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-logo.png
     :target: http://platformio.org
 
 `PlatformIO <http://platformio.org>`_ is an open source ecosystem for IoT
-development. Cross-platform code builder and library manager. Continuous and
-IDE integration. Arduino and MBED compatible. Ready for Cloud compiling.
+development. Cross-platform build system and library manager. Continuous and
+IDE integration. Arduino, ESP8266 and ARM mbed compatible
 
+* **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)
@@ -59,27 +60,29 @@ 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,
-libOpenCM3, etc.*
+*Atmel AVR & SAM, Espressif, Freescale Kinetis, Intel ARC32, Lattice iCE40,
+Microchip PIC32, Nordic nRF51, NXP LPC, Silicon Labs EFM32, ST STM32,
+TI MSP430 & Tiva, Teensy, Arduino, mbed, libOpenCM3, etc.*
 
 .. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-demo-wiring.gif
     :target: http://platformio.org
 
-* `Get Started <http://platformio.org/#!/get-started>`_
-* `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
-* `Development Platforms <http://platformio.org/#!/platforms>`_
-* `Frameworks <http://platformio.org/#!/frameworks>`_
-* `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
-* `Library Manager <http://docs.platformio.org/en/latest/librarymanager/index.html>`_
-* `User Guide <http://docs.platformio.org/en/latest/userguide/index.html>`_
-* `Continuous Integration <http://docs.platformio.org/en/latest/ci/index.html>`_
-* `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 Notes <http://docs.platformio.org/en/latest/history.html>`_
+* `PlatformIO Plus and professional solutions <https://pioplus.com>`_
+* `PlatformIO IDE <http://platformio.org/platformio-ide>`_
+* `Get Started <http://platformio.org/get-started>`_
+* `Library Search and Registry <http://platformio.org/lib>`_
+* `Development Platforms <http://platformio.org/platforms>`_
+* `Frameworks <http://platformio.org/frameworks>`_
+* `Embedded Boards Explorer <http://platformio.org/boards>`_
+* `Library Manager <http://docs.platformio.org/en/stable/librarymanager/index.html>`_
+* `User Guide <http://docs.platformio.org/en/stable/userguide/index.html>`_
+* `Continuous Integration <http://docs.platformio.org/en/stable/ci/index.html>`_
+* `IDE Integration <http://docs.platformio.org/en/stable/ide.html>`_
+* `Articles about us <http://docs.platformio.org/en/stable/articles.html>`_
+* `FAQ <http://docs.platformio.org/en/stable/faq.html>`_
+* `Release Notes <http://docs.platformio.org/en/stable/history.html>`_
 
 Use whenever. *Run everywhere.*
 -------------------------------
@@ -93,17 +96,17 @@ sized computers (`Raspberry Pi <http://www.raspberrypi.org>`_,
 Embedded Development. *Easier Than Ever.*
 -----------------------------------------
 *PlatformIO* is well suited for embedded development and has pre-configured
-settings for most popular `Embedded Boards <http://platformio.org/#!/boards>`_.
+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
+* `IDE Integration <http://docs.platformio.org/en/stable/ide.html>`_ with
   *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>`_
+* Cloud compiling and `Continuous Integration <http://docs.platformio.org/en/stable/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
-  `build -flags/-options <http://docs.platformio.org/en/latest/projectconf.html#build-flags>`_
+* Built-in `Serial Port Monitor <http://docs.platformio.org/en/stable/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ and configurable
+  `build -flags/-options <http://docs.platformio.org/en/stable/projectconf.html#build-flags>`_
 * Automatic **firmware uploading**
-* Pre-built tool chains, frameworks for the popular `Hardware Platforms <http://platformio.org/#!/platforms>`_
+* Pre-built tool chains, frameworks for the popular `Hardware Platforms <http://platformio.org/platforms>`_
 
 .. image:: https://raw.githubusercontent.com/platformio/platformio-web/develop/app/images/platformio-embedded-development.png
     :target: http://platformio.org
@@ -114,10 +117,10 @@ The Missing Library Manager. *It's here!*
 *PlatformIO Library Manager* is the missing library manager for development
 platforms which allows you to organize and have up-to-date external libraries.
 
-* Friendly `Command-Line Interface <http://docs.platformio.org/en/latest/librarymanager/index.html>`_
-* Modern `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
+* Friendly `Command-Line Interface <http://docs.platformio.org/en/stable/librarymanager/index.html>`_
+* Modern `Web 2.0 Library Search <http://platformio.org/lib>`_
 * Open Source `Library Registry API <https://github.com/platformio/platformio-api>`_
-* Library Crawler based on `library.json <http://docs.platformio.org/en/latest/librarymanager/config.html>`_
+* Library Crawler based on `library.json <http://docs.platformio.org/en/stable/librarymanager/config.html>`_
   specification
 * Library **dependency management**
 * Automatic library updating
@@ -126,7 +129,7 @@ platforms which allows you to organize and have up-to-date external libraries.
     :target: http://platformio.org
     :alt:  PlatformIO Library Manager Architecture
 
-Smart Code Builder. *Fast and Reliable.*
+Smart Build System. *Fast and Reliable.*
 ----------------------------------------
 *PlatformIO Code Builder* is built-on a next-generation software construction
 tool named `SCons <http://www.scons.org/>`_. Think of *SCons* as an improved,
@@ -136,72 +139,62 @@ cross-platform substitute for the classic *Make* utility.
 * Reliable detection of *build changes*
 * Improved support for *parallel builds*
 * Ability to share *built files in a cache*
-* Lookup for external libraries which are installed via `Library Manager <http://docs.platformio.org/en/latest/librarymanager/index.html>`_
+* Lookup for external libraries which are installed via `Library Manager <http://docs.platformio.org/en/stable/librarymanager/index.html>`_
 
 .. image:: https://raw.githubusercontent.com/platformio/platformio-web/develop/app/images/platformio-scons-builder.png
     :target: http://platformio.org
-    :alt:  PlatformIO Code Builder Architecture
+    :alt:  PlatformIO Build System Architecture
 
 Single source code. *Multiple platforms.*
 -----------------------------------------
 *PlatformIO* allows the developer to compile the same code with different
 development platforms using only *One Command*
-`platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`_.
+`platformio run <http://docs.platformio.org/en/stable/userguide/cmd_run.html>`_.
 This happens due to
-`Project Configuration File (platformio.ini) <http://docs.platformio.org/en/latest/projectconf.html>`_
+`Project Configuration File (platformio.ini) <http://docs.platformio.org/en/stable/projectconf.html>`_
 where you can setup different environments with specific options (platform
 type, firmware uploading settings, pre-built framework, build flags and many
 more).
 
 It has support for the most popular embedded platforms:
 
-* `Atmel AVR <http://platformio.org/#!/platforms/atmelavr>`_
-* `Atmel SAM <http://platformio.org/#!/platforms/atmelsam>`_
-* `Espressif <http://platformio.org/#!/platforms/espressif>`_
-* `Freescale Kinetis <http://platformio.org/#!/platforms/freescalekinetis>`_
-* `Nordic nRF51 <http://platformio.org/#!/platforms/nordicnrf51>`_
-* `NXP LPC <http://platformio.org/#!/platforms/nxplpc>`_
-* `ST STM32 <http://platformio.org/#!/platforms/ststm32>`_
-* `Silicon Labs EFM32 <http://platformio.org/#!/platforms/siliconlabsefm32>`_
-* `Teensy <http://platformio.org/#!/platforms/teensy>`_
-* `TI MSP430 <http://platformio.org/#!/platforms/timsp430>`_
-* `TI TIVA C <http://platformio.org/#!/platforms/titiva>`_
+* `Atmel AVR <http://platformio.org/platforms/atmelavr>`_
+* `Atmel SAM <http://platformio.org/platforms/atmelsam>`_
+* `Espressif <http://platformio.org/platforms/espressif>`_
+* `Freescale Kinetis <http://platformio.org/platforms/freescalekinetis>`_
+* `Intel ARC32 <http://platformio.org/platforms/intel_arc32>`_
+* `Lattice iCE40 <http://platformio.org/platforms/lattice_ice40>`_
+* `Microchip PIC32 <http://platformio.org/platforms/microchippic32>`_
+* `Nordic nRF51 <http://platformio.org/platforms/nordicnrf51>`_
+* `NXP LPC <http://platformio.org/platforms/nxplpc>`_
+* `ST STM32 <http://platformio.org/platforms/ststm32>`_
+* `Silicon Labs EFM32 <http://platformio.org/platforms/siliconlabsefm32>`_
+* `Teensy <http://platformio.org/platforms/teensy>`_
+* `TI MSP430 <http://platformio.org/platforms/timsp430>`_
+* `TI TIVA C <http://platformio.org/platforms/titiva>`_
 
 Frameworks:
 
-* `Arduino <http://platformio.org/#!/frameworks/arduino>`_
-* `CMSIS <http://platformio.org/#!/frameworks/cmsis>`_
-* `libOpenCM3 <http://platformio.org/#!/frameworks/libopencm3>`_
-* `Energia <http://platformio.org/#!/frameworks/energia>`_
-* `SPL <http://platformio.org/#!/frameworks/spl>`_
-* `mbed <http://platformio.org/#!/frameworks/mbed>`_
-* `WiringPi <http://platformio.org/#!/frameworks/wiringpi>`_
+* `Arduino <http://platformio.org/frameworks/arduino>`_
+* `CMSIS <http://platformio.org/frameworks/cmsis>`_
+* `Energia <http://platformio.org/frameworks/energia>`_
+* `libOpenCM3 <http://platformio.org/frameworks/libopencm3>`_
+* `mbed <http://platformio.org/frameworks/mbed>`_
+* `Simba <http://platformio.org/frameworks/simba>`_
+* `SPL <http://platformio.org/frameworks/spl>`_
+* `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>`_
+For further details, please refer to `What is PlatformIO? <http://docs.platformio.org/en/stable/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:
+See `contributing guidelines <https://github.com/platformio/platformio/blob/develop/CONTRIBUTING.md>`_.
 
-   * 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
+License
 -------
 
-Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+Copyright 2014-present PlatformIO <contact@platformio.org>
 
-The PlatformIO is licensed under the permissive Apache 2.0 licence,
+The PlatformIO is licensed under the permissive Apache 2.0 license,
 so you can use it in both commercial and personal projects with confidence.

appveyor.yml

@@ -1,27 +1,21 @@
 build: off
 environment:
-  global:
-    WITH_COMPILER: "cmd /E:ON /V:ON /C .\\scripts\\appveyor\\run_with_compiler.cmd"
+
   matrix:
     - TOXENV: "py27"
-      TOXPYTHON: "C:\\Python27-x64\\python.exe"
-      WINDOWS_SDK_VERSION: "v7.0"
-      PYTHON_HOME: "C:\\Python27-x64"
-      PYTHON_VERSION: "2.7"
-      PYTHON_ARCH: "64"
-      
-init:
-  - "ECHO %TOXENV%"
-  - ps: "ls C:\\Python*"
-  
+
 install:
-  - "git submodule update --init --recursive"
-  - "powershell scripts\\appveyor\\install.ps1"
-  
-before_test:
-  - cmd: SET PATH=%PATH%;C:\MinGW\bin  
-  
+  - cmd: git submodule update --init --recursive
+  - cmd: SET PATH=%PATH%;C:\Python27\Scripts;C:\MinGW\bin
+  - cmd: pip install tox
+
 test_script:
-  - "%PYTHON_HOME%\\Scripts\\tox --version"
-  - "%PYTHON_HOME%\\Scripts\\pip --version"
-  - "%WITH_COMPILER% %PYTHON_HOME%\\Scripts\\tox"
+  - cmd: tox
+
+notifications:
+  - provider: Slack
+    incoming_webhook:
+      secure: E9H0SU0Ju7WLDvgxsV8cs3J62T3nTTX7QkEjsczN0Sto/c9hWkVfhc5gGWUkxhlD975cokHByKGJIdwYwCewqOI+7BrcT8U+nlga4Uau7J8=
+    on_build_success: false
+    on_build_failure: true
+    on_build_status_changed: true

circle.yml

@@ -1,16 +0,0 @@
-machine:
-    python:
-        version: 2.7
-
-checkout:
-    post:
-        - git submodule update --init
-        - pip install -U pip setuptools virtualenv
-
-dependencies:
-    pre:
-        - pip install tox
-
-test:
-    override:
-        - tox -e py27

docs/_static/extra.css

@@ -1,5 +1,5 @@
 /**
- * Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+ * Copyright 2014-present PlatformIO <contact@platformio.org>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -35,10 +35,10 @@ nav {
     display: block !important;
   }
   body {
-    padding-top: 100px;
+    padding-top: 50px;
   }
   .wy-nav-side {
-    top: 100px;
+    top: 50px;
   }
 
   .container {
@@ -47,7 +47,7 @@ nav {
 }
 @media (min-width: 1200px) {
   .container {
-    width: 1170px;
+    width: 1150px;
   }
 }
 .container-fluid {
@@ -256,6 +256,58 @@ nav {
 
 /* Misc */
 
+.wy-side-scroll .wy-side-nav-search .icon,
+.wy-side-scroll .wy-side-nav-search .version {
+  display: none;
+  visibility: none;
+}
+
+@media (min-width: 768px) {
+  .wy-side-scroll {
+    padding-bottom: 50px;
+  }
+}
+
+.navbar-header .navbar-brand {
+  color: #e0e0e0;
+  background: url("../_static/platformio-logo-xs.png") no-repeat;
+  background-position: 5px 0;
+  padding-left: 50px;
+  font-weight: 500;
+}
+
+.navbar .github-corner {
+  display: none;
+}
+
+.navbar .github-corner svg {
+  fill: #fff;
+  color: #080808;
+  position: absolute;
+  top: -1px;
+  right: 0;
+  border: 0;
+  width: 50px;
+  height: 50px;
+  transform: scale(1, 1);
+}
+
+@media screen and (min-width: 992px) {
+  .navbar .github-corner {
+    display: block;
+  }
+}
+
+.navbar-inverse .navbar-nav > li.nav-pioplus > a,
+.navbar-inverse .navbar-nav > li.nav-pioplus > a:visited
+{
+  color: #ff6600;
+}
+
+.navbar-inverse .navbar-nav > li.nav-pioplus > a:hover {
+  color: #ff9900;
+}
+
 .top-banner {
   display: block;
   padding: 10px 20px;

docs/_templates/footer.html

@@ -3,24 +3,31 @@
 {% block extrafooter %}
 <link rel="stylesheet" href="{{ pathto('_static/extra.css', 1) }}" type="text/css" />
 <header id="pionav" class="navbar navbar-inverse navbar-fixed-top">
+  <a href="https://github.com/platformio" target="_blank" class="github-corner">
+    <svg viewBox="0 0 250 250">
+      <path d="M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z"></path>
+      <path d="M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2" fill="currentColor" style="transform-origin: 130px 106px;" class="octo-arm"></path>
+      <path d="M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z" fill="currentColor" class="octo-body"></path>
+    </svg>
+  </a>
   <div class="container container-fluid">
     <div class="navbar-header">
-      <a class="navbar-brand" href="http://platformio.org/"></i> PlatformIO</a>
+      <a class="navbar-brand" href="http://platformio.org">PlatformIO</a>
     </div>
 
     <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/platformio-ide"><i class="fa fa-cube fa-lg"></i>IDE</a></li>
+          <li><a href="http://platformio.org/platforms"><i class="fa fa-wrench fa-lg"></i>Development</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 class="active"><a href="http://docs.platformio.org"><i class="fa fa-book fa-lg"></i>Docs</a></li>
+          <li><a href="https://community.platformio.org"><i class="fa fa-comments-o fa-lg"></i>Community</a></li>
+          <li class="nav-pioplus"><a href="https://pioplus.com"><i class="fa fa-cubes fa-lg"></i>Plus</a></li>
         </ul>
       </div>
 

docs/articles.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,11 +18,56 @@ Articles about us
     If you've written article about PlatformIO and would like it listed on
     this page, `please edit this page <https://github.com/platformio/platformio/blob/develop/docs/articles.rst>`_.
 
-Here are recent articles about PlatformIO:
+Here are recent articles/reviews about PlatformIO:
 
 2016
 ^^^^
 
+* Sep 2, 2016 - **Tinkerman** `ESP8266: Optimizing files for SPIFFS with Gulp <http://tinkerman.cat/optimizing-files-for-spiffs-with-gulp/>`_
+* Aug 28, 2016 - **Tom Parker** `Using the BBC micro:bit with PlatformIO <http://www.lshift.net/blog/2016/08/28/using-the-bbc-microbit-with-platformio/>`_
+* Aug 24, 2016 - **Primal Cortex** `Cloud based continuous integration and delivery for IOT using PlatformIO <https://primalcortex.wordpress.com/2016/08/24/cloud-based-continuous-integration-and-delivery-for-iot-using-platformio/>`_
+* Aug 18, 2016 - **Primal Cortex** - `Installing PlatformIO on Arch Linux <https://primalcortex.wordpress.com/2016/08/18/platformio/>`_
+* Jul 26, 2016 - **Embedded Systems Laboratory** - `แนะนำการใช้งาน PlatformIO IDE สำหรับบอร์ด Arduino และ ESP8266 (Get started with PlatformIO IDE for Arduino board and ESP8266, Thai) <http://cpre.kmutnb.ac.th/esl/learning/index.php?article=intro_platformio-ide>`_
+* Jul 15, 2016 - **Jaime** - `ESP8266 Mobile Rick Roll Captive Portal <https://hackaday.io/project/12709-esp8266-mobile-rick-roll-captive-portal>`_
+* Jul 5, 2016 - **Ivan Kravets, Ph.D.** - `Explore the new development instruments for Arduino with PlatformIO ecosystem <http://www.slideshare.net/ivankravets/explore-the-new-development-instruments-for-arduino-with-platformio-ecosystem>`_
+* Jul 5, 2016 - **Belinda** - `Monte Bianco Arduino Developer Summit <http://www.arduino.org/blog/arduino-developer-summit>`_
+* Jul 1, 2016 - **Tam Hanna** - `Mikrocontroller-Gipfel in den Alpen: Arduino Developer Summit, Tag eins (Microcontroller peaks in the Alps: Arduino Developer Summit, Day One, German) <http://www.heise.de/make/meldung/Mikrocontroller-Gipfel-in-den-Alpen-Arduino-Developer-Summit-Tag-eins-3252421.html>`_
+* Jun 14, 2016 - **Glyn Hudson** - `OpenEnergyMonitor Part 2/3: Firmware Continuous Test & Build <https://blog.openenergymonitor.org/2016/06/auto-build-continuous-test-firmware/>`_
+* Jun 13, 2016 - **Daniel Eichhorn** - `New Weather Station Demo on Github <http://blog.squix.org/2016/06/new-weather-station-demo-on-github.html>`_
+* Jun 12, 2016 - **Glyn Hudson** - `OpenEnergyMonitor Part 1/3: PlatformIO open-source embedded development ecosystem <https://blog.openenergymonitor.org/2016/06/platformio/>`_
+* Jun 12, 2016 - **Uli Wolf** - `Nutzung von PlatformIO im Atom Editor zur Entwicklung von Arduino Code (Use PlatformIO and Atom Editor to develop Arduino code, German) <https://wolf-u.li/5668/nutzung-von-platform-io-im-atom-editor-zur-entwicklung-von-arduino-code/>`_
+* Jun 3, 2016 - **Daniel Eichhorn** - `ESP8266: Continuous Delivery Pipeline – Push To Production <http://blog.squix.org/2016/06/esp8266-continuous-delivery-pipeline-push-to-production.html>`_
+* May 30, 2016 - **Ron Moerman** - `IoT Development with PlatformIO <https://electronicsworkbench.io/blog/platformio>`_
+* May 29, 2016 - **Chris Synan** - `Reverse Engineer RF Remote Controller for IoT! <http://www.instructables.com/id/Reverse-Engineer-RF-Remote-Controller-for-IoT/?ALLSTEPS>`_
+* May 26, 2016 - **Charlie Key** - `7 Best Developer Tools To Build Your NEXT Internet of Things Application <https://www.losant.com/blog/7-best-developer-tools-to-build-your-next-internet-of-things-application>`_
+* May 22, 2016 - **Pedro Minatel** - `Estação meteorológica com ESP8266 (Weather station with ESP8266, Portuguese) <http://pedrominatel.com.br/esp8266/estacao-meteorologica-com-esp8266/>`_
+* May 16, 2016 - **Pedro Minatel** - `Controle remoto WiFi com ESP8266 (WiFi remote control using ESP8266, Portuguese) <http://pedrominatel.com.br/esp8266/controle-remoto-wifi-com-esp8266/>`_
+* May 11, 2016 - **Jo Vandeginste** - `Using PlatformIO to compile for Jeelabs' Jeenode Micro <http://jovandeginste.github.io/2016/05/11/using-platformio-to-compile-for-jeelabs-jeenode-micro.html>`_
+* May 08, 2016 - **Radoslaw Bob** - `Touch controlled buzzer (Nodemcu ESP8266) <https://gettoknowthebob.wordpress.com/2016/05/08/touch-controlled-buzzer-nodemcu-esp8266/>`_
+* May 06, 2016 - **Jean Roux** - `The IoT building blocks I use for my home-automation projects <http://iotplay.blogspot.com/2016/05/the-components-i-use-for-my-projects.html>`_
+* May 05, 2016 - **Ivan Kravets, Ph.D. / Eclipse Virtual IoT Meetup** - `PlatformIO: a cross-platform IoT solution to build them all! <http://www.meetup.com/Virtual-IoT/events/229964142/>`_
+* May 01, 2016 - **Pedro Minatel** - `PlatformIO – Uma alternativa ao Arduino IDE (PlatformIO - An alternative to the Arduino IDE, Portuguese) <http://pedrominatel.com.br/ferramentas/platformio-uma-alternativa-ao-arduino-ide/>`_
+* Apr 23, 2016 - **Al Williams** - `Hackaday: Atomic Arduino (and Other) Development <http://hackaday.com/2016/04/23/atomic-arduino-and-other-development/>`_
+* Apr 16, 2016 - **Sathittham Sangthong** - `[PlatformIO] มาลองเล่น PlatformIO แทน Arduino IDE กัน (Let's play together with PlatformIO IDE [alternative to Arduino IDE], Thai) <http://www.sathittham.com/platformio/platformio-ide/>`_
+* Apr 15, 2016 - **Daniel Eichhorn** - `ESP8266: Offline Debugging with the Platformio Environment <http://blog.squix.org/2016/04/esp8266-offline-debugging-with.html>`_
+* Apr 11, 2016 - **Matjaz Trcek** - `Top 5 Arduino integrated development environments <https://codeandunicorns.com/top-5-arduino-integrated-development-environments-ide/>`_
+* Apr 06, 2016 - **Aleks** - `PlatformIO ausprobiert (Tried PlatformIO, German) <http://5volt-junkie.net/platformio/>`_
+* Apr 02, 2016 - **Diego Pinto** - `Você tem coragem de abandonar a IDE do Arduino? PlatformIO + Atom (Do you dare to leave the Arduino IDE? PlatformIO + Atom, Portuguese) <http://www.clubemaker.com.br/?rota=artigo/81>`_
+* Mar 30, 2016 - **Brandon Cannaday** - `Getting Started with PlatformIO and ESP8266 NodeMcu <https://www.losant.com/blog/getting-started-with-platformio-esp8266-nodemcu>`_
+* Mar 29, 2016 - **Pablo Peñalve** - `PlatformIO + Geany + Raspberry PI, Spanish <http://ret-catriel.blogspot.com/2016/03/framework-platformio-geany-raspberry-pi.html>`_
+* Mar 24, 2016 - **NAzT** - `PlatformIO และการปรับแต่ง เพื่อใช้สำหรับพัฒนา Arduino Library (PlatformIO and advanced development for Arduino Library, Thai) <http://cmmakerclub.com/2016/03/tools-2/config-platformio-for-arduino-framework-developer/>`_
+* Mar 16, 2016 - **Jakub Skořepa** - `Instalace PlatformIO (PlatformIO IDE Installation, Czech) <http://ok1kvk.cz/clanek/2016/instalace-platformio/>`_
+* Mar 12, 2016 - **Peter Marks** - `PlatformIO, the Arduino IDE for programmers <http://blog.marxy.org/2016/03/platformio-arduino-ide-for-programmers.html>`_
+* Mar 12, 2016 - **Richard Arthurs** - `Getting Started With PlatformIO <http://richarthurs.com/2016/03/12/platformio-review-and-first-thoughts/>`_
+* Mar 07, 2016 - **Joran Jessurun** - `Nieuwe wereld met PlatformIO (New world with PlatformIO, Dutch) <http://blog.wisclub.nl/#post178>`_
+* Mar 05, 2016 - **brichacek.net** - `PlatformIO – otevřený ekosystém pro vývoj IoT (PlatformIO – an open source ecosystem for IoT development, Czech) <http://blog.brichacek.net/platformio-otevreny-ekosystem-pro-vyvoj-iot/>`_
+* Mar 04, 2016 - **Ricardo Vega** - `Programa tu Arduino desde Atom (Program your Arduino from Atom, Spanish) <http://ricveal.com/blog/programa-arduino-desde-atom/>`_
+* Feb 28, 2016 - **Alex Bloggt** - `PlatformIO vorgestellt (Introduction to PlatformIO IDE, German) <https://alexbloggt.com/platformio-vorgestellt/>`_
+* Feb 25, 2016 - **NutDIY** - `PlatformIO Blink On Nodemcu Dev Kit V1.0 (Thai) <http://nutdiy.blogspot.com/2016/02/platformio-blink-on-nodemcu-dev-kit-v10.html>`_
+* Feb 23, 2016 - **Ptarmigan Labs** - `ESP8266 Over The Air updating – what are the options? <https://ptarmiganlabs.com/blog/2016/02/23/esp8266-over-the-air-updating-what-are-the-options/>`_
+* Feb 22, 2016 - **Grzegorz Hołdys** - `How to Integrate PlatformIO with Netbeans <http://www.instructables.com/id/How-to-Integrate-PlatformIO-With-Netbeans/>`_
+* Feb 19, 2016 - **Embedds** - `Develop easier with PlatformIO ecosystem <http://www.embedds.com/develop-easier-with-platformio-ecosystem/>`_
+* Feb 13, 2016 - **Robert Cudmore** - `Programming an arduino with PlatformIO <http://blog.cudmore.io/post/2016/02/13/Programming-an-arduino-with-platformio/>`_
 * 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>`_
@@ -58,14 +103,14 @@ Here are recent articles about PlatformIO:
 * May 17, 2015 - **S.S** - `コマンドラインでArduino開発 : vim + platformio (Arduino development at the command line: VIM + PlatformIO, Japanese) <http://qiita.com/caad1229/items/7b5fb47f034ae6e0baf2>`_
 * May 11, 2015 - **IT Hare** - `From Web Developer to Embedded One: Interview with Ivan Kravets, The Guy Behind PlatformIO. Part II <http://ithare.com/from-web-developer-to-embedded-one-interview-with-ivan-kravets-the-guy-behind-platformio-part-ii/>`_
 * May 4, 2015 - **IT Hare** - `From Web Developer to Embedded One: Interview with Ivan Kravets, The Guy Behind PlatformIO. Part I <http://ithare.com/from-web-development-to-embedded-one-interview-with-ivan-kravets-the-guy-behind-platformio-part-i/>`_
-* April 17, 2015 - **Michael Ball** - `PlatformIO - A Cross-Platform Code Builder and Missing Library Manager <http://arduino-pi.blogspot.com.es/2015/04/platformio-cross-platform-code-builder.html>`_
-* March 23, 2015 - **Atmel** - `Cross-board and cross-vendor embedded development with PlatformIO <http://blog.atmel.com/2015/03/23/cross-board-and-cross-vendor-embedded-development-with-platformio/>`_
-* March 22, 2015 - **Mark VandeWettering** - `Discovered a new tool for embedded development: PlatformIO <http://brainwagon.org/2015/03/22/discovered-a-new-tool-for-embedded-development-platformio/>`_
-* February 25, 2015 - **Hendrik Putzek** - `Use your favourite IDE together with Arduino <http://blog.putzek.com/2015/02/your-favourite-ide-with-arduino.html>`_
+* Apr 17, 2015 - **Michael Ball** - `PlatformIO - A Cross-Platform Code Builder and Missing Library Manager <http://arduino-pi.blogspot.com.es/2015/04/platformio-cross-platform-code-builder.html>`_
+* Mar 23, 2015 - **Atmel** - `Cross-board and cross-vendor embedded development with PlatformIO <http://blog.atmel.com/2015/03/23/cross-board-and-cross-vendor-embedded-development-with-platformio/>`_
+* Mar 22, 2015 - **Mark VandeWettering** - `Discovered a new tool for embedded development: PlatformIO <http://brainwagon.org/2015/03/22/discovered-a-new-tool-for-embedded-development-platformio/>`_
+* Feb 25, 2015 - **Hendrik Putzek** - `Use your favourite IDE together with Arduino <http://blog.putzek.com/2015/02/your-favourite-ide-with-arduino.html>`_
 
 2014
 ^^^^
 
-* October 7, 2014 - **Ivan Kravets, Ph.D.** - `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>`_
-* 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>`_
-* June 17, 2014 - **Ivan Kravets, Ph.D.** - `How was PlatformIO born or why I love Python World <http://www.ikravets.com/computer-life/programming/2014/06/17/how-was-platformio-born-or-why-i-love-python-world>`_
+* Oct 7, 2014 - **Ivan Kravets, Ph.D.** - `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>`_
+* Jun 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>`_
+* Jun 17, 2014 - **Ivan Kravets, Ph.D.** - `How was PlatformIO born or why I love Python World <http://www.ikravets.com/computer-life/programming/2014/06/17/how-was-platformio-born-or-why-i-love-python-world>`_

docs/ci/appveyor.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -44,142 +44,20 @@ Put ``appveyor.yml`` to the root directory of the GitHub repository.
 
     build: off
     environment:
-        global:
-            WITH_COMPILER: "cmd /E:ON /V:ON /C .\\scripts\\appveyor\\run_with_compiler.cmd"
-        matrix:
-            - PLATFORMIO_CI_SRC: "path\\to\\source\\file.c"
-              PLATFORMIO_CI_SRC: "path\\to\\source\\file.ino"
-              PLATFORMIO_CI_SRC: "path\\to\\source\\directory"
-              WINDOWS_SDK_VERSION: "v7.0"
-              PYTHON_HOME: "C:\\Python27-x64"
-              PYTHON_VERSION: "2.7"
-              PYTHON_ARCH: "64"
-        install:
-          - "git submodule update --init --recursive"
-          - "powershell scripts\\appveyor\\install.ps1"
-        before_test:
-          - cmd: SET PATH=%PATH%;%PYTHON_HOME%;%PYTHON_HOME%\Scripts
-        test_script:
-          - '%WITH_COMPILER% %PYTHON_HOME%\\Scripts\\platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N'
 
+      matrix:
+        - PLATFORMIO_CI_SRC: "path\\to\\source\\file.c"
+        - PLATFORMIO_CI_SRC: "path\\to\\source\\file.ino"
+        - PLATFORMIO_CI_SRC: "path\\to\\source\\directory"
 
-Then create ``scripts/appveyor`` folder and put these 2 scripts (they are the
-same for the all projects, don't need to modify them):
+    install:
+        - cmd: git submodule update --init --recursive
+        - cmd: SET PATH=%PATH%;C:\Python27\Scripts
+        - cmd: pip install -U platformio
 
-1. ``scripts/appveyor/install.ps1``:
+    test_script:
+        - cmd: platformio ci --board=<ID_1> --board=<ID_2> --board=<ID_N>
 
-.. code-block:: PowerShell
-
-    $BASE_URL = "https://www.python.org/ftp/python/"
-    $GET_PIP_URL = "https://bootstrap.pypa.io/get-pip.py"
-    $GET_PIP_PATH = "C:\get-pip.py"
-
-
-    function DownloadPython ($python_version, $platform_suffix) {
-        $webclient = New-Object System.Net.WebClient
-        $filename = "python-" + $python_version + $platform_suffix + ".msi"
-        $url = $BASE_URL + $python_version + "/" + $filename
-
-        $basedir = $pwd.Path + "\"
-        $filepath = $basedir + $filename
-        if (Test-Path $filename) {
-            Write-Host "Reusing" $filepath
-            return $filepath
-        }
-
-        # Download and retry up to 5 times in case of network transient errors.
-        Write-Host "Downloading" $filename "from" $url
-        $retry_attempts = 3
-        for($i=0; $i -lt $retry_attempts; $i++){
-            try {
-                $webclient.DownloadFile($url, $filepath)
-                break
-            }
-            Catch [Exception]{
-                Start-Sleep 1
-            }
-       }
-       Write-Host "File saved at" $filepath
-       return $filepath
-    }
-
-
-    function InstallPython ($python_version, $architecture, $python_home) {
-        Write-Host "Installing Python" $python_version "for" $architecture "bit architecture to" $python_home
-        if (Test-Path $python_home) {
-            Write-Host $python_home "already exists, skipping."
-            return $false
-        }
-        if ($architecture -eq "32") {
-            $platform_suffix = ""
-        } else {
-            $platform_suffix = ".amd64"
-        }
-        $filepath = DownloadPython $python_version $platform_suffix
-        Write-Host "Installing" $filepath "to" $python_home
-        $args = "/qn /i $filepath TARGETDIR=$python_home"
-        Write-Host "msiexec.exe" $args
-        Start-Process -FilePath "msiexec.exe" -ArgumentList $args -Wait -Passthru
-        Write-Host "Python $python_version ($architecture) installation complete"
-        return $true
-    }
-
-
-    function InstallPip ($python_home) {
-        $python_path = $python_home + "/python.exe"
-        Write-Host "Installing pip..."
-        $webclient = New-Object System.Net.WebClient
-        $webclient.DownloadFile($GET_PIP_URL, $GET_PIP_PATH)
-        Write-Host "Executing:" $python_path $GET_PIP_PATH
-        Start-Process -FilePath "$python_path" -ArgumentList "$GET_PIP_PATH" -Wait -Passthru
-    }
-
-    function InstallPackage ($python_home, $pkg) {
-        $pip_path = $python_home + "/Scripts/pip.exe"
-        & $pip_path install -U $pkg
-    }
-
-    function main () {
-        InstallPython $env:PYTHON_VERSION $env:PYTHON_ARCH $env:PYTHON_HOME
-        InstallPip $env:PYTHON_HOME
-        InstallPackage $env:PYTHON_HOME setuptools
-        InstallPackage $env:PYTHON_HOME platformio
-    }
-
-    main
-
-2. ``scripts/appveyor/run_with_compiler.cmd``:
-
-.. code-block:: guess
-
-    @ECHO OFF
-
-    SET COMMAND_TO_RUN=%*
-    SET WIN_SDK_ROOT=C:\Program Files\Microsoft SDKs\Windows
-
-    SET MAJOR_PYTHON_VERSION="%PYTHON_VERSION:~0,1%"
-    IF %MAJOR_PYTHON_VERSION% == "2" (
-        SET WINDOWS_SDK_VERSION="v7.0"
-    ) ELSE IF %MAJOR_PYTHON_VERSION% == "3" (
-        SET WINDOWS_SDK_VERSION="v7.1"
-    ) ELSE (
-        ECHO Unsupported Python version: "%MAJOR_PYTHON_VERSION%"
-        EXIT 1
-    )
-
-    IF "%PYTHON_ARCH%"=="64" (
-        ECHO Configuring Windows SDK %WINDOWS_SDK_VERSION% for Python %MAJOR_PYTHON_VERSION% on a 64 bit architecture
-        SET DISTUTILS_USE_SDK=1
-        SET MSSdk=1
-        "%WIN_SDK_ROOT%\%WINDOWS_SDK_VERSION%\Setup\WindowsSdkVer.exe" -q -version:%WINDOWS_SDK_VERSION%
-        "%WIN_SDK_ROOT%\%WINDOWS_SDK_VERSION%\Bin\SetEnv.cmd" /x64 /release
-        ECHO Executing: %COMMAND_TO_RUN%
-        call %COMMAND_TO_RUN% || EXIT 1
-    ) ELSE (
-        ECHO Using default MSVC build environment for 32 bit architecture
-        ECHO Executing: %COMMAND_TO_RUN%
-        call %COMMAND_TO_RUN% || EXIT 1
-    )
 
 For more details as for PlatformIO build process please look into :ref:`cmd_ci`
 command.
@@ -194,20 +72,16 @@ Examples
 
     build: off
     environment:
-        global:
-            WITH_COMPILER: "cmd /E:ON /V:ON /C .\\scripts\\appveyor\\run_with_compiler.cmd"
-        matrix:
-            - PLATFORMIO_CI_SRC: "examples\\Bluetooth\\PS3SPP\\PS3SPP.ino"
-              PLATFORMIO_CI_SRC: "examples\\pl2303\\pl2303_gps\\pl2303_gps.ino"
-              WINDOWS_SDK_VERSION: "v7.0"
-              PYTHON_HOME: "C:\\Python27-x64"
-              PYTHON_VERSION: "2.7"
-              PYTHON_ARCH: "64"
-        install:
-          - "git submodule update --init --recursive"
-          - "powershell scripts\\appveyor\\install.ps1"
-        before_test:
-          - cmd: SET PATH=%PATH%;%PYTHON_HOME%;%PYTHON_HOME%\Scripts
-          - cmd: git clone https://github.com/xxxajk/spi4teensy3.git c:\spi4teensy
-        test_script:
-          - '%WITH_COMPILER% %PYTHON_HOME%\\Scripts\\platformio ci --lib="." --lib="c:\spi4teensy" --board=uno --board=teensy31 --board=due'
+
+      matrix:
+        - PLATFORMIO_CI_SRC: "examples\\Bluetooth\\PS3SPP\\PS3SPP.ino"
+        - PLATFORMIO_CI_SRC: "examples\\pl2303\\pl2303_gps\\pl2303_gps.ino"
+
+    install:
+        - cmd: git submodule update --init --recursive
+        - cmd: SET PATH=%PATH%;C:\Python27\Scripts
+        - cmd: pip install -U platformio
+        - cmd: git clone https://github.com/xxxajk/spi4teensy3.git C:\spi4teensy
+
+    test_script:
+        - cmd: platformio ci --lib="." --lib="C:\\spi4teensy" --board=uno --board=teensy31 --board=due

docs/ci/circleci.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -49,9 +49,9 @@ guide first.
 
     test:
         override:
-            - platformio ci path/to/test/file.c --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-            - platformio ci examples/file.ino --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-            - platformio ci path/to/test/directory --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+            - platformio ci path/to/test/file.c --board=<ID_1> --board=<ID_2> --board=<ID_N>
+            - platformio ci examples/file.ino --board=<ID_1> --board=<ID_2> --board=<ID_N>
+            - platformio ci path/to/test/directory --board=<ID_1> --board=<ID_2> --board=<ID_N>
 
 
 For more details as for PlatformIO build process please look into :ref:`cmd_ci`.
@@ -65,7 +65,7 @@ it), please use ``--lib="."`` option for :ref:`cmd_ci` command
 .. code-block:: yaml
 
     script:
-        - platformio ci --lib="." --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+        - platformio ci --lib="." --board=<ID_1> --board=<ID_2> --board=<ID_N>
 
 Library dependecies
 ~~~~~~~~~~~~~~~~~~~
@@ -82,12 +82,12 @@ Install dependent library using :ref:`librarymanager`
             # Install the latest stable PlatformIO
             - sudo pip install -U platformio
 
-            # OneWire Library with ID=1 http://platformio.org/#!/lib/show/1/OneWire
-            - platformio lib install 1
+            # OneWire Library with ID=1 http://platformio.org/lib/show/1/OneWire
+            - platformio lib -g install 1
 
     test:
         override:
-            - platformio ci path/to/test/file.c --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+            - platformio ci path/to/test/file.c --board=<ID_1> --board=<ID_2> --board=<ID_N>
 
 Manually download dependent library and include in build process via ``--lib`` option
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -105,7 +105,7 @@ Manually download dependent library and include in build process via ``--lib`` o
 
     test:
         override:
-            - platformio ci path/to/test/file.c --lib="/tmp/OneWire-master" --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+            - platformio ci path/to/test/file.c --lib="/tmp/OneWire-master" --board=<ID_1> --board=<ID_2> --board=<ID_N>
 
 Custom Build Flags
 ~~~~~~~~~~~~~~~~~~
@@ -152,14 +152,14 @@ Examples
             - sudo pip install -U platformio
 
             # pre-install PlatformIO development platforms, they will be cached
-            - platformio platforms install atmelavr atmelsam teensy
+            - platformio platform install atmelavr atmelsam teensy
 
             #
             # Libraries from PlatformIO Library Registry:
             #
-            # http://platformio.org/#!/lib/show/416/TinyGPS
-            # http://platformio.org/#!/lib/show/417/SPI4Teensy3
-            - platformio lib install 416 417
+            # http://platformio.org/lib/show/416/TinyGPS
+            # http://platformio.org/lib/show/417/SPI4Teensy3
+            - platformio lib -g install 416 417
 
     test:
         override:

docs/ci/drone.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -51,7 +51,7 @@ Please fill all fields for your project in the Drone control panel:
 .. code-block:: bash
 
     pip install -U platformio
-    platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+    platformio ci --board=<ID_1> --board=<ID_2> --board=<ID_N>
 
 .. image:: ../_static/droneci-platformio-integration-1.png
 

docs/ci/index.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -58,7 +58,7 @@ GitHub repository.
         - pip install -U platformio
 
     script:
-        - platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+        - platformio ci --board=<ID_1> --board=<ID_2> --board=<ID_N>
 
 
 For more details as for PlatformIO build process please look into :ref:`cmd_ci`

docs/ci/travis.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -72,7 +72,7 @@ PlatformIO is written in Python and is recommended to be run within
         - pip install -U platformio
 
     script:
-        - platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+        - platformio ci --board=<ID_1> --board=<ID_2> --board=<ID_N>
 
 Then perform steps 1, 2 and 4 from http://docs.travis-ci.com/user/getting-started/
 
@@ -87,10 +87,10 @@ it), please use ``--lib="."`` option for :ref:`cmd_ci` command
 .. code-block:: yaml
 
     script:
-        - platformio ci --lib="." --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+        - platformio ci --lib="." --board=<ID_1> --board=<ID_2> --board=<ID_N>
 
-Library dependecies
-~~~~~~~~~~~~~~~~~~~
+Library dependencies
+~~~~~~~~~~~~~~~~~~~~
 
 There 2 options to test source code with dependent libraries:
 
@@ -105,8 +105,8 @@ Install dependent library using :ref:`librarymanager`
         #
         # Libraries from PlatformIO Library Registry:
         #
-        # http://platformio.org/#!/lib/show/1/OneWire
-        platformio lib install 1
+        # http://platformio.org/lib/show/1/OneWire
+        - platformio lib -g install 1
 
 Manually download dependent library and include in build process via ``--lib`` option
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -117,11 +117,11 @@ Manually download dependent library and include in build process via ``--lib`` o
         - pip install -U platformio
 
         # download library to the temporary directory
-        wget https://github.com/PaulStoffregen/OneWire/archive/master.zip -O /tmp/onewire_source.zip
-        unzip /tmp/onewire_source.zip -d /tmp/
+        - wget https://github.com/PaulStoffregen/OneWire/archive/master.zip -O /tmp/onewire_source.zip
+        - unzip /tmp/onewire_source.zip -d /tmp/
 
     script:
-        - platformio ci --lib="/tmp/OneWire-master" --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+        - platformio ci --lib="/tmp/OneWire-master" --board=<ID_1> --board=<ID_2> --board=<ID_N>
 
 Custom Build Flags
 ~~~~~~~~~~~~~~~~~~
@@ -137,8 +137,7 @@ PlatformIO allows to specify own build flags using :envvar:`PLATFORMIO_BUILD_FLA
 
     install:
         - pip install -U platformio
-
-        export PLATFORMIO_BUILD_FLAGS=-D GLOBAL_MACROS_FOR_ALL_TEST_ENV
+        - export PLATFORMIO_BUILD_FLAGS="-D GLOBAL_MACROS_FOR_ALL_TEST_ENV"
 
 
 For the more details, please follow to
@@ -188,9 +187,9 @@ Examples
         #
         # Libraries from PlatformIO Library Registry:
         #
-        # http://platformio.org/#!/lib/show/416/TinyGPS
-        # http://platformio.org/#!/lib/show/417/SPI4Teensy3
-        - platformio lib install 416 417
+        # http://platformio.org/lib/show/416/TinyGPS
+        # http://platformio.org/lib/show/417/SPI4Teensy3
+        - platformio lib -g install 416 417
 
     script:
         - platformio ci --board=uno --board=teensy31 --board=due --lib="."
@@ -247,10 +246,10 @@ Examples
             - "~/.platformio"
 
     env:
-        - PLATFORMIO_CI_SRC=examples/TimeArduinoDue PLATFORMIO_CI_BOARDS_ARGS="--board=due"
+        - PLATFORMIO_CI_SRC=examples/TimeArduinoDue PLATFORMIO_CI_EXTRA_ARGS="--board=due"
         - PLATFORMIO_CI_SRC=examples/TimeGPS
         - PLATFORMIO_CI_SRC=examples/TimeNTP
-        - PLATFORMIO_CI_SRC=examples/TimeTeensy3 PLATFORMIO_CI_BOARDS_ARGS="--board=teensy31"
+        - PLATFORMIO_CI_SRC=examples/TimeTeensy3 PLATFORMIO_CI_EXTRA_ARGS="--board=teensy31"
         # - ...
 
     install:
@@ -260,11 +259,11 @@ Examples
         #
         # Libraries from PlatformIO Library Registry:
         #
-        # http://platformio.org/#!/lib/show/416/TinyGPS
-        - platformio lib install 416 421 422
+        # http://platformio.org/lib/show/416/TinyGPS
+        - platformio lib -g install 416 421 422
 
     script:
-        - if [[ $PLATFORMIO_CI_BOARDS_ARGS ]]; then bash -c 'platformio ci --lib="." $PLATFORMIO_CI_BOARDS_ARGS'; else bash -c 'platformio ci --lib="." --board=uno --board=teensy20pp'; fi
+        - platformio ci --lib="." --board=uno --board=teensy20pp $PLATFORMIO_CI_EXTRA_ARGS
 
 * Configuration file: https://github.com/ivankravets/Time/blob/master/.travis.yml
 * Build History: https://travis-ci.org/ivankravets/Time

docs/conf.py

@@ -45,7 +45,7 @@ master_doc = 'index'
 
 # General information about the project.
 project = u'PlatformIO'
-copyright = u'2014-2016, Ivan Kravets'
+copyright = u'2014-present, PlatformIO'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -199,7 +199,7 @@ latex_elements = {
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
     ('index', 'PlatformIO.tex', u'PlatformIO Documentation',
-     u'Ivan Kravets', 'manual'),
+     u'PlatformIO', 'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
@@ -229,7 +229,7 @@ latex_documents = [
 # (source start file, name, description, authors, manual section).
 man_pages = [
     ('index', 'platformio', u'PlatformIO Documentation',
-     [u'Ivan Kravets'], 1)
+     [u'PlatformIO'], 1)
 ]
 
 # If true, show URL addresses after external links.
@@ -243,7 +243,7 @@ man_pages = [
 #  dir menu entry, description, category)
 texinfo_documents = [
     ('index', 'PlatformIO', u'PlatformIO Documentation',
-     u'Ivan Kravets', 'PlatformIO', 'One line description of project.',
+     u'PlatformIO', 'PlatformIO', 'One line description of project.',
      'Miscellaneous'),
 ]
 

docs/demo.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,17 +19,17 @@ Demo & Projects
 Project Examples
 ----------------
 
-Preconfigured demo projects are located in `PlatformIO GitHub <https://github.com/platformio/platformio/tree/develop/examples>`_ repository.
+Pre-configured demo projects are located in `PlatformIO GitHub <https://github.com/platformio/platformio-examples/tree/develop>`_ repository.
 
-Wiring Blink
-------------
+"Blink Project"
+---------------
 
 .. image:: _static/platformio-demo-wiring.gif
 
 Used in demo
 ~~~~~~~~~~~~
 
-1. Source code of `Wiring Blink Example <https://github.com/platformio/platformio/tree/develop/examples/wiring-blink>`_
+1. Source code of `Wiring Blink Example <https://github.com/platformio/platformio-examples/tree/develop/wiring-blink>`_
 2. :ref:`cmd_run` command
 3. :ref:`platformio run -t upload <cmd_run>` command.
 
@@ -41,11 +41,11 @@ Platform Manager
 Used in demo
 ~~~~~~~~~~~~
 
-1. :ref:`userguide_platforms`
-2. :ref:`cmd_platforms_list` command
-3. :ref:`platformio platforms search avr <cmd_platforms_search>` command
-4. :ref:`platformio platforms show teensy <cmd_platforms_show>` command
-5. :ref:`cmd_platforms_update` command.
+1. :ref:`userguide_platform`
+2. :ref:`cmd_platform_list` command
+3. :ref:`platformio platform search avr <cmd_platform_search>` command
+4. :ref:`platformio platform show teensy <cmd_platform_show>` command
+5. :ref:`cmd_platform_update` command.
 
 Library Manager
 ---------------

docs/envvars.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -35,8 +35,8 @@ PlatformIO handles ``CI`` variable which is setup by
 `Continuous Integration <http://en.wikipedia.org/wiki/Continuous_integration>`_
 (Travis, Circle and etc.) systems.
 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``.
+``CI=true`` automatically setup :envvar:`PLATFORMIO_DISABLE_PROGRESSBAR` to
+``true``.
 
 .. envvar:: PLATFORMIO_FORCE_COLOR
 
@@ -57,6 +57,10 @@ Allows to override :ref:`projectconf` option :ref:`projectconf_pio_home_dir`.
 
 Allows to override :ref:`projectconf` option :ref:`projectconf_pio_lib_dir`.
 
+.. envvar:: PLATFORMIO_LIBDEPS_DIR
+
+Allows to override :ref:`projectconf` option :ref:`projectconf_pio_libdeps_dir`.
+
 .. envvar:: PLATFORMIO_SRC_DIR
 
 Allows to override :ref:`projectconf` option :ref:`projectconf_pio_src_dir`.
@@ -69,14 +73,32 @@ Allows to override :ref:`projectconf` option :ref:`projectconf_pio_envs_dir`.
 
 Allows to override :ref:`projectconf` option :ref:`projectconf_pio_data_dir`.
 
+.. envvar:: PLATFORMIO_TEST_DIR
 
-Builder
--------
+Allows to override :ref:`projectconf` option :ref:`projectconf_pio_test_dir`.
+
+
+Building
+--------
 
 .. envvar:: PLATFORMIO_BUILD_FLAGS
 
 Allows to set :ref:`projectconf` option :ref:`projectconf_build_flags`.
 
+Examples:
+
+.. code-block:: bash
+
+    # Unix:
+    export PLATFORMIO_BUILD_FLAGS=-DFOO
+    export PLATFORMIO_BUILD_FLAGS="-DFOO -DBAR=1 -DFLOAT_VALUE=1.23457e+07"
+    export PLATFORMIO_BUILD_FLAGS="'-DWIFI_PASS=\"My password\"' '-DWIFI_SSID=\"My ssid name\"'"
+
+    # Windows:
+    SET PLATFORMIO_BUILD_FLAGS=-DFOO
+    SET PLATFORMIO_BUILD_FLAGS=-DFOO -DBAR=1 -DFLOAT_VALUE=1.23457e+07
+    SET PLATFORMIO_BUILD_FLAGS='-DWIFI_PASS="My password"' '-DWIFI_SSID="My ssid name"'
+
 .. envvar:: PLATFORMIO_SRC_BUILD_FLAGS
 
 Allows to set :ref:`projectconf` option :ref:`projectconf_src_build_flags`.
@@ -89,6 +111,22 @@ Allows to set :ref:`projectconf` option :ref:`projectconf_src_filter`.
 
 Allows to set :ref:`projectconf` option :ref:`projectconf_extra_script`.
 
+.. envvar:: PLATFORMIO_LIB_EXTRA_DIRS
+
+Allows to set :ref:`projectconf` option :ref:`projectconf_lib_extra_dirs`.
+
+
+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
 --------
@@ -116,10 +154,15 @@ Allows to override setting :ref:`setting_check_platformio_interval`.
 
 Allows to override setting :ref:`setting_check_platforms_interval`.
 
-.. envvar:: PLATFORMIO_SETTING_ENABLE_PROMPTS
-
-Allows to override setting :ref:`setting_enable_prompts`.
-
 .. envvar:: PLATFORMIO_SETTING_ENABLE_TELEMETRY
 
 Allows to override setting :ref:`setting_enable_telemetry`.
+
+.. envvar:: PLATFORMIO_SETTING_FORCE_VERBOSE
+
+Allows to override setting :ref:`setting_force_verbose`.
+
+
+.. envvar:: PLATFORMIO_SETTING_DISABLE_SSL
+
+Allows to override setting :ref:`setting_disable_ssl`.

docs/faq.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,58 +14,24 @@
 Frequently Asked Questions
 ==========================
 
+.. note::
+   We have a big database with `Frequently Asked Questions in our Community Forums <https://community.platformio.org/c/faq>`_.
+   Please have a look at it.
+
 .. contents::
 
 General
 -------
 
-.. _faq_what_is_platformio:
-
 What is PlatformIO?
 ~~~~~~~~~~~~~~~~~~~
 
-`PlatformIO <http://platformio.org>`_ is an open source ecosystem for IoT
-development.
+Please refer to :ref:`what_is_pio`
 
-PlatformIO is independent from the platform, in which it is running. In fact,
-the only requirement is Python, which exists pretty much everywhere. What this
-means is that PlatformIO projects can be easily moved from one computer to
-another, as well as that PlatformIO allows for the easy sharing of projects
-between team members, regardless of operating system they prefer to work with.
-Beyond that, PlatformIO can be run not only on commonly used desktops/laptops
-but also on the servers without X Window System. While PlatformIO itself is a
-console application, it can be used in combination with one's favorite
-:ref:`ide` or text editor such as :ref:`ide_arduino`, :ref:`ide_atom`,
-:ref:`ide_clion`, :ref:`ide_eclipse`, :ref:`ide_qtcreator`,
-:ref:`ide_sublimetext`, :ref:`ide_vim`, :ref:`ide_visualstudio`, etc.
+What is ``.pioenvs`` directory
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-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 approximately 200
-`Embedded Boards <http://platformio.org/#!/boards>`_ and all major
-:ref:`Development Platforms <platforms>`.
-
-PlatformIO allows users to:
-
-* Decide which operation system they want to run development process on.
-  You can even use one OS at home and another at work.
-* Choose which editor to use for writing the code. It can be pretty simple
-  editor or powerful favorite :ref:`ide`.
-* Focus on the code development, significantly simplifying support for the
-  :ref:`platforms` and MCUs.
-
-
-How does it work?
-~~~~~~~~~~~~~~~~~
-
-Without going too deep into PlatformIO implementation details, work cycle of
-the project developed using PlatformIO is as follows:
-
-* Users choose board(s) interested in :ref:`projectconf`
-* Based on this list of boards, PlatformIO downloads required toolchains and
-  installs them automatically.
-* Users develop code and PlatformIO makes sure that it is compiled, prepared
-  and uploaded to all the boards of interest.
+Please refer to :ref:`projectconf_pio_envs_dir`.
 
 Command completion in Terminal
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -97,6 +63,18 @@ To enable ``zsh`` completion please run these commands:
     For permanent command completion you need to place commands above to
     ``~/.bashrc`` or ``~/.zshrc`` file.
 
+PlatformIO IDE
+--------------
+
+Please refer to :ref:`PlatformIO IDE Frequently Asked Questions <ide_atom_faq>`.
+
+Before/Pre and After/Post build actions
+---------------------------------------
+
+PlatformIO Build System has rich API that allows to attach different pre-/post
+actions (hooks). See features of :ref:`projectconf_extra_script` option for
+:ref:`projectconf`.
+
 .. _faq_troubleshooting:
 
 Troubleshooting
@@ -127,8 +105,7 @@ Where is ``platformio`` binary installed? Run this command in Terminal
     # for Unix
     which platformio
     echo $PATH
-
-    # for Windows OS
+ Windows OS
     where platformio
     echo %PATH%
 
@@ -162,21 +139,6 @@ Please upgrade *SetupTools* package:
 Miscellaneous
 ~~~~~~~~~~~~~
 
-.. _faq_troubleshooting_pioblocksprompt:
-
-PlatformIO blocks command execution using user prompt
-'''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-If you are going to run *PlatformIO* from **subprocess**, you **MUST
-DISABLE** all prompts. It will allow you to avoid blocking.
-There are a few options:
-
-- using :option:`platformio --force` option before each command
-- using environment variable :envvar:`PLATFORMIO_SETTING_ENABLE_PROMPTS=No <PLATFORMIO_SETTING_ENABLE_PROMPTS>`
-- disable global setting ``enable_prompts`` via :ref:`cmd_settings` command
-- masking under Continuous Integration system via environment variable
-  :envvar:`CI=true <CI>`.
-
 Serial does not work with panStampAVR board
 '''''''''''''''''''''''''''''''''''''''''''
 
@@ -185,12 +147,6 @@ Answered in `issue #144 <https://github.com/platformio/platformio/issues/144#iss
 Building
 ~~~~~~~~
 
-Can not compile a library that compiles without issue with Arduino IDE
-''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-* `#298: Unable to use Souliss library <https://github.com/platformio/platformio/issues/298>`_
-* `#331: Unable to use MySensors library <https://github.com/platformio/platformio/issues/331>`_
-
 ARM toolchain: cc1plus: error while loading shared libraries
 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 

docs/frameworks/cmsis.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -35,7 +35,7 @@ Boards
 
 .. note::
     * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
+      `PlatformIO Boards Explorer <http://platformio.org/boards>`_
     * For more detailed ``board`` information please scroll tables below by horizontal.
 
 Armstrap

docs/frameworks/cmsis_extra.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,6 +20,6 @@ Examples
 --------
 
 All project examples are located in PlatformIO repository
-`Examples for CMSIS framework <https://github.com/platformio/platformio/tree/develop/examples/stm32>`_.
+`Examples for CMSIS framework <https://github.com/platformio/platformio-examples/tree/develop/stm32>`_.
 
-* `Blink <https://github.com/platformio/platformio/tree/develop/examples/stm32/stm32-cmsis-blink>`_
+* `Blink <https://github.com/platformio/platformio-examples/tree/develop/stm32/stm32-cmsis-blink>`_

docs/frameworks/energia.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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 @@
 
 Framework ``energia``
 =====================
-Energia framework enables pretty much anyone to start easily creating microcontroller-based projects and applications. Its easy-to-use libraries and functions provide developers of all experience levels to start blinking LEDs, buzzing buzzers and sensing sensors more quickly than ever before.
+Energia Wiring-based framework enables pretty much anyone to start easily creating microcontroller-based projects and applications. Its easy-to-use libraries and functions provide developers of all experience levels to start blinking LEDs, buzzing buzzers and sensing sensors more quickly than ever before.
 
 For more detailed information please visit `vendor site <http://energia.nu/reference/>`_.
 
@@ -38,7 +38,7 @@ Boards
 
 .. note::
     * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
+      `PlatformIO Boards Explorer <http://platformio.org/boards>`_
     * For more detailed ``board`` information please scroll tables below by horizontal.
 
 TI
@@ -75,6 +75,13 @@ TI
       - 128 Kb
       - 1 Kb
 
+    * - ``lpmsp430fr4133``
+      - `TI LaunchPad w/ msp430fr4133 <http://www.ti.com/tool/msp-exp430fr4133>`_
+      - MSP430FR4133
+      - 16 MHz
+      - 16 Kb
+      - 2 Kb
+
     * - ``lpmsp430fr5739``
       - `TI FraunchPad w/ msp430fr5739 <http://www.ti.com/tool/msp-exp430fr5739>`_
       - MSP430FR5739
@@ -89,6 +96,13 @@ TI
       - 64 Kb
       - 1 Kb
 
+    * - ``lpmsp430fr6989``
+      - `TI LaunchPad w/ msp430fr6989 <http://www.ti.com/tool/msp-exp430fr6989>`_
+      - MSP430FR6989
+      - 16 MHz
+      - 128 Kb
+      - 2 Kb
+
     * - ``lpmsp430g2231``
       - `TI LaunchPad w/ msp430g2231 (1 MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
       - MSP430G2231

docs/frameworks/index.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,5 +22,6 @@ Frameworks
     energia
     libopencm3
     mbed
+    simba
     spl
     wiringpi

docs/frameworks/libopencm3.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -38,7 +38,7 @@ Boards
 
 .. note::
     * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
+      `PlatformIO Boards Explorer <http://platformio.org/boards>`_
     * For more detailed ``board`` information please scroll tables below by horizontal.
 
 ST

docs/frameworks/libopencm3_extra.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,6 +13,6 @@ Examples
 --------
 
 All project examples are located in PlatformIO repository
-`Examples for libOpenCM3 framework <https://github.com/platformio/platformio/tree/develop/examples/stm32>`_.
+`Examples for libOpenCM3 framework <https://github.com/platformio/platformio-examples/tree/develop/stm32>`_.
 
-* `Blink <https://github.com/platformio/platformio/tree/develop/examples/stm32/stm32-opencm3-blink>`_
+* `Blink <https://github.com/platformio/platformio-examples/tree/develop/stm32/stm32-opencm3-blink>`_

docs/frameworks/mbed.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,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.
 
@@ -43,16 +46,36 @@ Platforms
       - The STM32 family of 32-bit Flash MCUs based on the ARM Cortex-M processor is designed to offer new degrees of freedom to MCU users. It offers a 32-bit product range that combines very high performance, real-time capabilities, digital signal processing, and low-power, low-voltage operation, while maintaining full integration and ease of development.
 
     * - :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.
+      - 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 USB cable and a PC or Macintosh with a USB port.
 
 Boards
 ------
 
 .. note::
     * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
+      `PlatformIO Boards Explorer <http://platformio.org/boards>`_
     * For more detailed ``board`` information please scroll tables below by horizontal.
 
+96Boards
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``b96b_f446ve``
+      - `96Boards B96B-F446VE <https://developer.mbed.org/platforms/ST-B96B-F446VE/>`_
+      - STM32F446VET6
+      - 168 MHz
+      - 512 Kb
+      - 128 Kb
+
 Atmel
 ~~~~~
 
@@ -87,6 +110,26 @@ Atmel
       - 256 Kb
       - 32 Kb
 
+BBC
+~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``bbcmicrobit``
+      - `BBC micro:bit <https://developer.mbed.org/platforms/Microbit/>`_
+      - NRF51822
+      - 16 MHz
+      - 256 Kb
+      - 16 Kb
+
 CQ Publishing
 ~~~~~~~~~~~~~
 
@@ -223,6 +266,26 @@ Freescale
       - 256 Kb
       - 32 Kb
 
+Generic
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``bluepill_f103c8``
+      - `BluePill F103C8 <http://www.st.com/content/st_com/en/products/microcontrollers/stm32-32-bit-arm-cortex-mcus/stm32f1-series/stm32f103/stm32f103c8.html>`_
+      - STM32F103C8T6
+      - 72 MHz
+      - 64 Kb
+      - 20 Kb
+
 JKSoft
 ~~~~~~
 
@@ -243,6 +306,26 @@ JKSoft
       - 128 Kb
       - 16 Kb
 
+MultiTech
+~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``mts_mdot_f411re``
+      - `MultiTech mDot F411 <https://developer.mbed.org/platforms/MTS-mDot-F411/>`_
+      - STM32F411RET6
+      - 100 MHz
+      - 512 Kb
+      - 128 Kb
+
 NGX Technologies
 ~~~~~~~~~~~~~~~~
 
@@ -295,7 +378,7 @@ NXP
       - LPC1768
       - 96 MHz
       - 512 Kb
-      - 32 Kb
+      - 64 Kb
 
 Nordic
 ~~~~~~
@@ -545,6 +628,13 @@ ST
       - 512 Kb
       - 96 Kb
 
+    * - ``nucleo_f410rb``
+      - `ST Nucleo F410RB <https://developer.mbed.org/platforms/ST-Nucleo-F410RB/>`_
+      - STM32F410RBT6
+      - 100 MHz
+      - 128 Kb
+      - 32 Kb
+
     * - ``nucleo_f411re``
       - `ST Nucleo F411RE <https://developer.mbed.org/platforms/ST-Nucleo-F411RE/>`_
       - STM32F411RET6
@@ -559,6 +649,13 @@ ST
       - 512 Kb
       - 128 Kb
 
+    * - ``nucleo_l031k6``
+      - `ST Nucleo L031K6 <https://developer.mbed.org/platforms/ST-Nucleo-L031K6/>`_
+      - STM32L031K6T6
+      - 32 MHz
+      - 32 Kb
+      - 8 Kb
+
     * - ``nucleo_l053r8``
       - `ST Nucleo L053R8 <https://developer.mbed.org/platforms/ST-Nucleo-L053R8/>`_
       - STM32L053R8T6
@@ -566,6 +663,13 @@ ST
       - 64 Kb
       - 8 Kb
 
+    * - ``nucleo_l073rz``
+      - `ST Nucleo L073RZ <https://developer.mbed.org/platforms/ST-Nucleo-L073RZ/>`_
+      - STM32L073RZ
+      - 32 MHz
+      - 192 Kb
+      - 20 Kb
+
     * - ``nucleo_l152re``
       - `ST Nucleo L152RE <https://developer.mbed.org/platforms/ST-Nucleo-L152RE/>`_
       - STM32L152RET6
@@ -593,6 +697,13 @@ SeeedStudio
       - Flash
       - RAM
 
+    * - ``seeedArchMax``
+      - `SeeedStudio Arch Max <https://developer.mbed.org/platforms/Seeed-Arch-Max/>`_
+      - STM32F407VET6
+      - 168 MHz
+      - 512 Kb
+      - 192 Kb
+
     * - ``seeedTinyBLE``
       - `SeeedStudio Seeed Tiny BLE <http://developer.mbed.org/platforms/Seeed-Tiny-BLE/>`_
       - NRF51822
@@ -605,7 +716,7 @@ SeeedStudio
       - LPC1768
       - 96 MHz
       - 512 Kb
-      - 32 Kb
+      - 64 Kb
 
 Silicon Labs
 ~~~~~~~~~~~~
@@ -641,6 +752,13 @@ Silicon Labs
       - 256 Kb
       - 32 Kb
 
+    * - ``efm32pg_stk3401``
+      - `Silicon Labs SLSTK3401A (Pearl Gecko) <https://developer.mbed.org/platforms/EFM32-Pearl-Gecko/>`_
+      - EFM32PG1B200F256
+      - 40 MHz
+      - 256 Kb
+      - 32 Kb
+
     * - ``efm32wg_stk3800``
       - `Silicon Labs EFM32WG-STK3800 (Wonder Gecko) <https://developer.mbed.org/platforms/EFM32-Wonder-Gecko/>`_
       - EFM32WG990F256
@@ -740,6 +858,6 @@ u-blox
       - LPC1768
       - 96 MHz
       - 512 Kb
-      - 32 Kb
+      - 64 Kb
 
 .. include:: mbed_extra.rst

docs/frameworks/mbed_extra.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,10 +23,10 @@ Examples
 --------
 
 All project examples are located in PlatformIO repository
-`Examples for MBED framework <https://github.com/platformio/platformio/tree/develop/examples/mbed>`_.
+`Examples for MBED framework <https://github.com/platformio/platformio-examples/tree/develop/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>`_
+* `Blink <https://github.com/platformio/platformio-examples/tree/develop/mbed/mbed-blink>`_
+* `DSP <https://github.com/platformio/platformio-examples/tree/develop/mbed/mbed-dsp>`_
+* `HTTP Client <https://github.com/platformio/platformio-examples/tree/develop/mbed/mbed-http-client>`_
+* `RTOS <https://github.com/platformio/platformio-examples/tree/develop/mbed/mbed-rtos>`_
+* `Serial <https://github.com/platformio/platformio-examples/tree/develop/mbed/mbed-serial>`_

docs/frameworks/simba.rst

@@ -0,0 +1,169 @@
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
+    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_simba:
+
+Framework ``simba``
+===================
+Simba is an RTOS and build framework. It aims to make embedded programming easy and portable.
+
+For more detailed information please visit `vendor site <http://simba-os.readthedocs.org>`_.
+
+.. contents::
+
+Platforms
+---------
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Description
+
+    * - :ref:`platform_atmelavr`
+      - Atmel AVR 8- and 32-bit MCUs deliver a unique combination of performance, power efficiency and design flexibility. Optimized to speed time to market-and easily adapt to new ones-they are based on the industrys most code-efficient architecture for C and assembly programming.
+
+    * - :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_espressif8266`
+      - 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.
+
+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.
+
+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
+
+Arduino
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``due``
+      - `Arduino Due (Programming Port) <http://www.arduino.org/products/boards/4-arduino-boards/arduino-due>`_
+      - SAM3X8E
+      - 84 MHz
+      - 512 Kb
+      - 32 Kb
+
+    * - ``megaatmega2560``
+      - `Arduino Mega or Mega 2560 ATmega2560 (Mega 2560) <http://www.arduino.org/products/boards/4-arduino-boards/arduino-mega-2560>`_
+      - ATMEGA2560
+      - 16 MHz
+      - 256 Kb
+      - 8 Kb
+
+    * - ``nanoatmega328``
+      - `Arduino Nano ATmega328 <http://www.arduino.org/products/boards/4-arduino-boards/arduino-nano>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``uno``
+      - `Arduino Uno <http://www.arduino.org/products/boards/4-arduino-boards/arduino-uno>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+Espressif
+~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``esp01``
+      - `Espressif Generic ESP8266 ESP-01 512k <http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family>`_
+      - ESP8266
+      - 80 MHz
+      - 512 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
+
+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
+
+.. include:: simba_extra.rst

docs/frameworks/simba_extra.rst

@@ -0,0 +1,18 @@
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
+    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 Simba framework <https://github.com/platformio/platformio-examples/tree/develop/examples/simba>`_.
+
+* `Blink <https://github.com/platformio/platformio-examples/tree/develop/simba/blink>`_

docs/frameworks/spl.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -35,7 +35,7 @@ Boards
 
 .. note::
     * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
+      `PlatformIO Boards Explorer <http://platformio.org/boards>`_
     * For more detailed ``board`` information please scroll tables below by horizontal.
 
 Armstrap

docs/frameworks/spl_extra.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,6 +13,6 @@ Examples
 --------
 
 All project examples are located in PlatformIO repository
-`Examples for SPL framework <https://github.com/platformio/platformio/tree/develop/examples/stm32>`_.
+`Examples for SPL framework <https://github.com/platformio/platformio-examples/tree/develop/stm32>`_.
 
-* `Blink <https://github.com/platformio/platformio/tree/develop/examples/stm32/stm32-spl-blink>`_
+* `Blink <https://github.com/platformio/platformio-examples/tree/develop/stm32/stm32-spl-blink>`_

docs/frameworks/wiringpi.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -35,7 +35,7 @@ Boards
 
 .. note::
     * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
+      `PlatformIO Boards Explorer <http://platformio.org/boards>`_
     * For more detailed ``board`` information please scroll tables below by horizontal.
 
 Raspberry Pi

docs/frameworks/wiringpi_extra.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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 @@ Examples
 --------
 
 All project examples are located in PlatformIO repository
-`Examples for WiringPi framework <https://github.com/platformio/platformio/tree/develop/examples/raspberrypi>`_.
+`Examples for WiringPi framework <https://github.com/platformio/platformio-examples/tree/develop/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>`_
+* `Blink <https://github.com/platformio/platformio-examples/tree/develop/raspberrypi/wiringpi-blink>`_
+* `Serial <https://github.com/platformio/platformio-examples/tree/develop/raspberrypi/wiringpi-serial>`_

docs/history.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,11 +18,11 @@ IDE Integration
     :maxdepth: 2
 
     ide/atom
-    ide/arduino
     ide/clion
+    ide/codeblocks
     ide/eclipse
     ide/emacs
-    ide/energia
+    ide/netbeans
     ide/qtcreator
     ide/sublimetext
     ide/vim

docs/ide/_platformio_ide_extra.rst

@@ -0,0 +1,31 @@
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
+    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.
+
+.. note::
+    We are proud to present our official `PlatformIO IDE <http://platformio.org/platformio-ide>`_ -
+    The next-generation integrated development environment for IoT.
+
+    * Cross-platform build system without external dependencies to the OS software:
+
+        - 250+ embedded boards
+        - 20+ 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``)
+
+    `Install PlatformIO IDE <http://platformio.org/platformio-ide>`_.

docs/ide/arduino.rst

@@ -1,50 +0,0 @@
-..  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_arduino:
-
-Arduino
-=======
-
-The open-source `Arduino Software (IDE) <http://arduino.cc/en/main/software>`_
-makes it easy to write code and upload it to the board. It runs on *Windows,
-Mac OS X, and Linux*. The environment is written in *Java* and based on
-*Processing* and other open-source software.
-
-This software can be used with:
-
-* :ref:`platform_atmelavr`
-* :ref:`platform_atmelsam`
-* :ref:`framework_arduino`
-
-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
-----------
-
-.. image:: ../_static/ide-platformio-arduino.png
-    :target: http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides

docs/ide/atom.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,66 +14,255 @@
 PlatformIO IDE for Atom
 =======================
 
-PlatformIO IDE for `Atom <https://atom.io>`_ is the missing integrated
-development environment which provides comprehensive facilities
-for IoT development:
+PlatformIO IDE is the next-generation integrated development environment for IoT:
 
-* Cross-platform builder without external dependencies to the system
-  software:
+* Cross-platform build system without external dependencies to the OS software:
 
-    - 200+ embedded boards
-    - 15+ development platforms
+    - 250+ embedded boards
+    - 20+ development platforms
     - 10+ frameworks
 
-* C/C++ Intelligent code completion
-* C/C++ Smart code linter
+* C/C++ Intelligent Code Completion
+* C/C++ Smart Code Linter for rapid professional development
 * Library Manager for the hundreds popular libraries
-* Built-in Terminal with :ref:`PlatformIO CLI <userguide>` (``pio``, ``platformio``)
+* Multi-projects workflow with multiple panes
+* Themes support with dark and light colors
+* Serial Port Monitor
+* Built-in Terminal with :ref:`PlatformIO CLI <userguide>` tool (``pio``, ``platformio``)
 
-Atom is a 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.
 
-.. warning::
+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.
 
-    PlatformIO IDE is **in beta testing**. Please report all issues to
-    `PlatformIO IDE issues tracker <https://github.com/platformio/platformio-atom-ide/issues>`_.
+.. image:: ../_static/ide-atom-platformio.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio.png
 
 .. contents::
 
-Requirements
-------------
-
-The only one requirement is `Python Interpreter <https://www.python.org>`_.
-PlatformIO is written in Python and works on Mac OS X, Linux, Windows OS and
-ARM-based credit-card sized computers (Raspberry Pi, BeagleBone, CubieBoard).
-
 Installation
 ------------
 
-:Python:
+PlatformIO IDE is the next-generation integrated development environment for IoT.
+It's built on top of `GitHub's Atom "hackable" text editor <https://atom.io>`_.
+If you have already Atom installed, please install `PlatformIO IDE for Atom package <https://atom.io/packages/platformio-ide>`_.
 
-    Python is installed on Mac OS X and Linux OS by default. The only **Windows Users**
-    should install it manually. 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 ``python`` command will not be available.
+.. note::
+    You don't need to install PlatformIO CLI separately to system.
+    PlatformIO CLI is built into PlatformIO IDE and you will be able to use it
+    within PlatformIO IDE Terminal.
 
-:Atom: Download and install `Atom <https://atom.io>`_ source code editor
+1. Python Interpreter
+~~~~~~~~~~~~~~~~~~~~~
 
-:PlatformIO IDE:
+PlatformIO IDE is based on PlatformIO CLI which is written in
+`Python <https://www.python.org/downloads/>`_. Python is installed by default
+on the all popular OS except Windows.
 
-    Install `platformio-ide <https://atom.io/packages/platformio-ide>`_ package
-    using:
+**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 ``python`` command will not be available.
+
+.. image:: ../_static/python-installer-add-path.png
+
+.. _ide_atom_installation_clang:
+
+2. Clang for Intelligent Code Autocompletion
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+PlatformIO IDE uses `clang <http://clang.llvm.org>`_ for the Intelligent Code
+Autocompletion. To check that ``clang`` is available in your system, please
+open Terminal and run ``clang --version``. If ``clang`` is not installed,
+then install it and restart Atom:
+
+- **Mac OS X**: `Install the latest Xcode <https://developer.apple.com/xcode/download/>`_
+  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.
+
+  .. image:: ../_static/clang-installer-add-path.png
+
+  .. warning::
+      If you see ``Failed to find MSBuild toolsets directory`` error in
+      the installation console, please ignore it and press any key to close
+      this window. PlatformIO IDE uses only Clang completion engine that
+      should work after it without any problems.
+
+- **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::
+    If some libraries are not visible in :ref:`ide_atom` and Code Completion or
+    Code Linting does not work properly, please perform  ``Menu: PlatformIO >
+    Rebuild C/C++ Project Index (Autocomplete, Linter)``
+
+3. IDE Installation
+~~~~~~~~~~~~~~~~~~~
+
+.. note::
+    If you don't have Atom installed yet, we propose to download
+    `PlatformIO IDE for Atom bundle <http://platformio.org/platformio-ide>`_
+    with built-in auto installer (optional).
+
+- Download and install the `latest official Atom text editor <https://atom.io>`_.
+- Open Atom Package Manager and install `platformio-ide <https://atom.io/packages/platformio-ide>`_
+   Atom package (be patient and let the installation complete)
+
+    - **Mac OS X**: ``Menu: Atom > Preferences > Install``
+    - **Windows**: ``Menu: File > Settings > Install``
+    - **Linux**: ``Menu: Edit > Preferences > Install``
+
+.. image:: ../_static/ide-atom-platformio-install.png
+
+.. _atom_ide_quickstart:
+
+Quick Start
+-----------
+
+This tutorial introduces you to the basics of PlatformIO IDE workflow and shows
+you a creation process of a simple "Blink" example. After finishing you will
+have a general understanding of how to work with projects in the IDE.
+
+Launch
+~~~~~~
+
+After installation, you launch PlatformIO IDE by opening Atom. Once Atom is
+open, PlatformIO IDE auto installer will continue to install dependent packages
+and PlatformIO CLI. Please be patient and let the installation complete. In the
+final result PlatformIO IDE will ask you to reload Atom window to apply
+installed components. Please click on ``Reload Now``. After it PlatformIO IDE is
+ready for using. Happy coding!
+
+Setting Up the Project
+~~~~~~~~~~~~~~~~~~~~~~
+
+1. To create a new project choose
+   ``Menu: PlatformIO > Initialize new Project or update existing`` or press
+   the corresponding icon in the PlatformIO toolbar as shown in the image below:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-1.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-1.png
+
+2. In the "New Project Menu" choose desired boards (more than one board is
+   allowed) and select a project directory. Then press "Initialize" button:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-2.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-2.png
+
+3. If everything is fine, you should see the success message and project tree
+   in the left panel:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-3.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-3.png
+
+4. Now, let's create the first project source file: right-click on the folder
+   ``src`` and choose ``New File``:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-4.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-4.png
+
+Enter filename ``main.cpp``:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-5.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-5.png
+
+Copy the next source code to the just created file ``main.cpp``:
+
+.. code-block:: cpp
+
+    /**
+     * Blink
+     * Turns on an LED on for one second,
+     * then off for one second, repeatedly.
+     */
+    #include "Arduino.h"
+
+    void setup()
+    {
+      // initialize LED digital pin as an output.
+      pinMode(LED_BUILTIN, OUTPUT);
+    }
+
+    void loop()
+    {
+      // turn the LED on (HIGH is the voltage level)
+      digitalWrite(LED_BUILTIN, HIGH);
+      // wait for a second
+      delay(1000);
+      // turn the LED off by making the voltage LOW
+      digitalWrite(LED_BUILTIN, LOW);
+       // wait for a second
+      delay(1000);
+    }
+
+Process Project
+~~~~~~~~~~~~~~~
+
+PlatformIO IDE proposes different ways to process project (build, clean,
+upload firmware, run other targets) using:
+
+    - :ref:`atom_ide_platformio_toolbar`
+    - :ref:`atom_ide_platformio_menu`
+    - :ref:`ide_atom_building_targets` and hotkeys
+
+.. image:: ../_static/ide-atom-platformio-quick-start-6.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-6.png
+
+5. Run ``Build`` and you should see green "success" result in the building
+   panel:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-7.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-7.png
+
+To upload firmware to the board run ``Upload``.
+
+6. What is more, you can run specific target or process project environment
+   using ``Menu: PlatformIO > Run other target...``
+   or call targets list from the status bar (bottom, left corner):
+
+.. image:: ../_static/ide-atom-platformio-quick-start-8.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-8.png
+
+And select desired target:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-9.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-9.png
+
+7. To run built-in terminal interface choose ``Menu: PlatformIO > Terminal`` or
+   press the corresponding icon in the PlatformIO toolbar:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-10.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-10.png
+
+It provides you fast access to all set of powerful PlatformIO CLI commands:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-11.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-11.png
+
+8. To run built-in "Serial Monitor" choose ``Menu: PlatformIO > Serial Monitor``
+   or press the corresponding icon in the PlatformIO toolbar:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-12.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-12.png
+
+It has several settings to adjust your connection:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-13.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-13.png
+
+And allows you to communicate with your board in an easy way:
+
+.. image:: ../_static/ide-atom-platformio-quick-start-14.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-atom-platformio-quick-start-14.png
 
-        - **Mac OS X**: ``Menu: Atom > Preferences > Install``
-        - **Windows**: ``Menu: File > Settings > Install``
-        - **Linux**: ``Menu: Edit > Preferences > Install``
 
 User Guide
 ----------
 
-.. image:: ../_static/ide-atom-platformio.png
-    :target: http://docs.platformio.org/en/latest/_images/ide-atom-platformio.png
+.. _atom_ide_platformio_menu:
 
 Menu item ``PlatformIO``
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -83,8 +272,35 @@ new menu item named ``Menu: PlatformIO`` (after ``Menu: Help`` item).
 
 .. image:: ../_static/ide-atom-platformio-menu-item.png
 
-Building / Uploading / etc.
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _atom_ide_platformio_toolbar:
+
+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
+* ||
+* Initialize new PlatformIO Project or update existing...
+* Add/Open Project Folder...
+* Find in Project...
+* ||
+* Terminal
+* Library Manager
+* Serial Monitor
+* ||
+* Settings
+* PlatformIO Documentation
+
+.. _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).
@@ -95,59 +311,192 @@ Building / Uploading / etc.
 * ``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>`_.
+More options ``Menu: PlatformIO > Settings > Build``.
 
-Code completion
-~~~~~~~~~~~~~~~
+Intelligent Code Autocompletion
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-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>`_.
+PlatformIO IDE uses `clang <http://clang.llvm.org>`_ for the Intelligent Code Autocompletion.
+To install it or check if it is already installed, please follow to step
+:ref:`ide_atom_installation_clang` from Installation guide.
 
 .. warning::
-    The libraries which are added, installed or used in the project
-    after initializing process will not be reflected in code completion. To fix
-    it you need to reinitialize project using ``Menu: PlatformIO > Initialize new Project (or update existing)``.
+    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
-~~~~~~~~~~~
+.. _ide_atom_smart_code_linter:
 
-PlatformIO IDE uses PlatformIO's pre-built GCC toolchains for code linting. You
-can customize it in ``.gcc-flags.json`` which will be generated for the selected
-board in the project directory using
-``Menu: PlatformIO > Initialize new Project (or update existing)``.
+Smart Code Linter
+~~~~~~~~~~~~~~~~~
+
+PlatformIO IDE uses PlatformIO's pre-built GCC toolchains for Smart Code Linter
+and rapid professional development.
+The configuration data are located in ``.gcc-flags.json``. This file will be
+automatically created and preconfigured when you initialize project using
+``Menu: PlatformIO > Initialize new PlatformIO Project or update existing...``.
 
 .. warning::
-    The libraries which are added, installed or used in the project
-    after initializing process will not be reflected in code linter. To fix
-    it you need to reinitialize project using ``Menu: PlatformIO > Initialize new Project (or update existing)``.
+    If some libraries are not visible in :ref:`ide_atom` and Code Completion or
+    Code Linting does not work properly, please perform  ``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 PlatformIO 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, terminals and etc.
-
-Serial Monitor
-~~~~~~~~~~~~~~
-
-Serial Monitor was temporary disabled in PlatformIO IDE 0.2.1. See
-`issue #17 <https://github.com/platformio/platformio-atom-ide/issues/17>`_.
-
-Temporary solution is to ``Menu: PlatformIO > Install Shell Commands`` and use
-:ref:`cmd_serialports_monitor` from system Terminal application (not built-in in
-PlatformIO IDE).
+other process, terminal and etc.
 
 Known issues
-~~~~~~~~~~~~
+------------
 
-* Built-in Terminal doesn't support ``STDIN`` interaction
+Smart Code Linter is disabled for Arduino files
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+:ref:`ide_atom_smart_code_linter` is disabled by default for Arduino files
+(``*.ino`` and ``.pde``) because they  are not valid C/C++ based
+source files:
+
+1. Missing includes such as ``#include <Arduino.h>``
+2. Function declarations are omitted.
+
+There are two solutions:
+
+.. contents::
+    :local:
+
+.. _ide_atom_knownissues_sclarduino_manually:
+
+Convert Arduino file to C++ manually
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+For example, we have the next ``Demo.ino`` file:
+
+.. code-block:: cpp
+
+    void setup () {
+        someFunction(13);
+    }
+
+    void loop() {
+        delay(1000);
+    }
+
+    void someFunction(int num) {
+    }
+
+Let's convert it to  ``Demo.cpp``:
+
+1. Add ``#include <Arduino.h>`` at the top of the source file
+2. Declare each custom function (excluding built-in, such as ``setup`` and ``loop``)
+   before it will be called.
+
+The final ``Demo.cpp``:
+
+.. code-block:: cpp
+
+    #include <Arduino.h>
+
+    void someFunction(int num);
+
+    void setup () {
+        someFunction(13);
+    }
+
+    void loop() {
+        delay(1000);
+    }
+
+    void someFunction(int num) {
+    }
+
+Force Arduino file as C++
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To force Smart Code Linter to use Arduino files as C++ please
+
+1. Open ``.gcc-flags.json`` file from the Initialized/Imported project and add
+   ``-x c++`` flag at the beginning of the value of ``gccDefaultCppFlags`` field:
+
+.. code-block:: json
+
+    {
+      "execPath": "...",
+      "gccDefaultCFlags": "...",
+      "gccDefaultCppFlags": "-x c++ -fsyntax-only ...",
+      "gccErrorLimit": 15,
+      "gccIncludePaths": "...",
+      "gccSuppressWarnings": false
+    }
+
+2. Perform all steps from :ref:`ide_atom_knownissues_sclarduino_manually`
+   (without renaming to ``.cpp``).
+
+Arch Linux: PlatformIO IDE Terminal issue
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Please read this article `Installing PlatformIO on Arch Linux <https://primalcortex.wordpress.com/2016/08/18/platformio/>`_.
+
+.. _ide_atom_faq:
+
+Frequently Asked Questions
+--------------------------
+
+Keep build panel visible
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+PlatformIO IDE hides build panel on success by default. Nevertheless, you can
+keep it visible all time. Please follow to
+``Menu: PlatformIO > Settings > Build`` and set ``Panel Visibility`` to
+``Keep Visible``.
+
+Key-bindings (toggle panel):
+
+* ``cmd+alt+v`` - Mac OS X
+* ``ctrl+alt+v`` - Windows/Linux
+
+Automatically save on build
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want automatically save all edited files when triggering a build, please follow to
+``Menu: PlatformIO > Settings > Build`` and check ``Automatically save on build``.
+
+Jump to Declaration
+~~~~~~~~~~~~~~~~~~~
+
+Click on a function/include, press ``F3`` and you will be taken directly to
+the declaration for that function.
+
+Code Formatting
+~~~~~~~~~~~~~~~
+
+You need to install `atom-beautify <https://atom.io/packages/atom-beautify>`_
+package and `C/C++ Uncrustify Code Beautifier <http://sourceforge.net/projects/uncrustify/>`_.
+
+Articles / Manuals
+------------------
+
+* Aug 18, 2016 - **Primal Cortex** - `Installing PlatformIO on Arch Linux <https://primalcortex.wordpress.com/2016/08/18/platformio/>`_
+* Jul 26, 2016 - **Embedded Systems Laboratory** - `แนะนำการใช้งาน PlatformIO IDE สำหรับบอร์ด Arduino และ ESP8266 (Get started with PlatformIO IDE for Arduino board and ESP8266, Thai) <http://cpre.kmutnb.ac.th/esl/learning/index.php?article=intro_platformio-ide>`_
+* May 30, 2016 - **Ron Moerman** - `IoT Development with PlatformIO <https://electronicsworkbench.io/blog/platformio>`_
+* May 01, 2016 - **Pedro Minatel** - `PlatformIO – Uma alternativa ao Arduino IDE (PlatformIO - An alternative to the Arduino IDE, Portuguese) <http://pedrominatel.com.br/ferramentas/platformio-uma-alternativa-ao-arduino-ide/>`_
+* Apr 23, 2016 - **Al Williams** - `Hackaday: Atomic Arduino (and Other) Development <http://hackaday.com/2016/04/23/atomic-arduino-and-other-development/>`_
+* Apr 16, 2016 - **Sathittham Sangthong** - `[PlatformIO] มาลองเล่น PlatformIO แทน Arduino IDE กัน (Let's play together with PlatformIO IDE [alternative to Arduino IDE], Thai) <http://www.sathittham.com/platformio/platformio-ide/>`_
+* Apr 11, 2016 - **Matjaz Trcek** - `Top 5 Arduino integrated development environments <https://codeandunicorns.com/top-5-arduino-integrated-development-environments-ide/>`_
+* Apr 06, 2016 - **Aleks** - `PlatformIO ausprobiert (Tried PlatformIO, German) <http://5volt-junkie.net/platformio/>`_
+* Apr 02, 2016 - **Diego Pinto** - `Você tem coragem de abandonar a IDE do Arduino? PlatformIO + Atom (Do you dare to leave the Arduino IDE? PlatformIO + Atom, Portuguese) <http://www.clubemaker.com.br/?rota=artigo/81>`_
+* Mar 30, 2016 - **Brandon Cannaday** - `Getting Started with PlatformIO and ESP8266 NodeMcu <https://www.getstructure.io/blog/getting-started-with-platformio-esp8266-nodemcu>`_
+* Mar 12, 2016 - **Peter Marks** - `PlatformIO, the Arduino IDE for programmers <http://blog.marxy.org/2016/03/platformio-arduino-ide-for-programmers.html>`_
+* Mar 05, 2016 - **brichacek.net** - `PlatformIO – otevřený ekosystém pro vývoj IoT (PlatformIO – an open source ecosystem for IoT development, Czech) <http://blog.brichacek.net/platformio-otevreny-ekosystem-pro-vyvoj-iot/>`_
+* Mar 04, 2016 - **Ricardo Vega** - `Programa tu Arduino desde Atom (Program your Arduino from Atom, Spanish) <http://ricveal.com/blog/programa-arduino-desde-atom/>`_
+* Feb 28, 2016 - **Alex Bloggt** - `PlatformIO vorgestellt (Introduction to PlatformIO IDE, German) <https://alexbloggt.com/platformio-vorgestellt/>`_
+* Feb 25, 2016 - **NutDIY** - `PlatformIO Blink On Nodemcu Dev Kit V1.0 (Thai) <http://nutdiy.blogspot.com/2016/02/platformio-blink-on-nodemcu-dev-kit-v10.html>`_
+
+See a full list with :ref:`articles`.

docs/ide/clion.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,66 +20,117 @@ initial version will support the GCC and Clang compilers and GDB debugger.
 Clion includes such features as a smart editor, code quality assurance,
 automated refactorings, project manager, integrated version control systems.
 
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
-Refer to the `CDT Documentation <https://www.jetbrains.com/clion/documentation/>`_
+Refer to the `CLion Documentation <https://www.jetbrains.com/clion/documentation/>`_
 page for more detailed information.
 
+.. image:: ../_static/ide-platformio-clion.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-platformio-clion.png
+
 .. contents::
 
 Integration
 -----------
 
-Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+Choose board ``ID`` 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%
+    platformio init --ide clion --board <ID>
 
     # For example, generate project for Arduino UNO
     platformio init --ide clion --board uno
 
 Then:
 
-1. Import this project via ``Menu: File > Import Project``
+1. Place source files (``*.c, *.cpp, *.h, *.hpp``) to ``src`` directory
+2. 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 (*DO NOT RUN*): ``Menu: Run > Build``.
+3. Open source file from ``src`` directory
+4. Build project (*DO NOT RUN*): ``Menu: Run > Build``.
+
+.. warning::
+
+    See know issue: :ref:`ide_clion_knownissues_inopde_not_supported` and how
+    to resolve it.
 
 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.
-* ``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`.
+* ``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`
+* ``PLATFORMIO_REBUILD_PROJECT_INDEX`` - Rebuild C/C++ Index for the Project.
+  Allows to fix code completion and code linting issues.
 
 .. 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).
+    after generating process wont be reflected in IDE. To fix it please run
+    ``PLATFORMIO_REBUILD_PROJECT_INDEX`` target.
 
-.. warning::
-    PlatformIO generates empty project by default and **code auto-completion
-    will not work!** To enable auto-completion please choose one of:
+Known issues
+------------
 
-    * Add source files ``*.c, *.cpp, etc`` to ``src`` directory and re-initialize
-      project with command above
-    * Manually correct ``add_executable`` command in ``CMakeLists.txt`` file
-      (will be created in project directory after initialization).
+.. _ide_clion_knownissues_inopde_not_supported:
 
-    ``*.ino`` file isn't acceptable for ``add_executable`` command. You should
-    convert it manually to ``*.cpp``. See `project example <https://github.com/platformio/platformio/tree/develop/examples/ide/clion>`_.
+Arduino ``.ino`` files are not supported
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+CLion uses "CMake" tool for code completion and code linting. As result, it
+doesn't support Arduino files (``*.ino`` and ``.pde``) because they are
+not valid C/C++ based source files:
+
+1. Missing includes such as ``#include <Arduino.h>``
+2. Function declarations are omitted.
+
+Convert Arduino file to C++ manually
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+For example, we have the next ``Demo.ino`` file:
+
+.. code-block:: cpp
+
+    void function setup () {
+        someFunction(13);
+    }
+
+    void function loop() {
+        delay(1000);
+    }
+
+    void someFunction(int num) {
+    }
+
+Let's convert it to  ``Demo.cpp``:
+
+1. Add ``#include <Arduino.h>`` at the top of the source file
+2. Declare each custom function (excluding built-in, such as ``setup`` and ``loop``)
+   before it will be called.
+
+The final ``Demo.cpp``:
+
+.. code-block:: cpp
+
+    #include <Arduino.h>
+
+    void someFunction(int num);
+
+    void function setup () {
+        someFunction(13);
+    }
+
+    void function loop() {
+        delay(1000);
+    }
+
+    void someFunction(int num) {
+    }
 
-    More info `CLion issue #CPP-3977 <https://youtrack.jetbrains.com/issue/CPP-3977>`_.
-    Active discussion is located in
-    `PlatformIO issue #132 <https://github.com/platformio/platformio/issues/132>`_.
 
 Articles / Manuals
 ------------------
@@ -90,16 +141,10 @@ Articles / Manuals
 
 See more :ref:`articles`.
 
-Screenshot
-----------
-
-.. image:: ../_static/ide-platformio-clion.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-clion.png
-
 Examples
 --------
 
 "Blink" Project
-^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~
 
-Source code of `CLion "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/clion>`_.
+Source code of `CLion "Blink" Project <https://github.com/platformio/platformio-examples/tree/develop/ide/clion>`_.

docs/ide/codeblocks.rst

@@ -0,0 +1,54 @@
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
+    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_codeblocks:
+
+CodeBlocks
+==========
+
+Code::Blocks is a free, open-source cross-platform IDE that supports multiple
+compilers including GCC, Clang and Visual C++. It is developed in C++ using
+wxWidgets as the GUI toolkit. Using a plugin architecture, its capabilities
+and features are defined by the provided plugins. Currently, Code::Blocks is
+oriented towards C, C++, and Fortran.
+
+CodeBlocks IDE can be downloaded from `here <http://www.codeblocks.org/downloads>`_.
+
+.. image:: ../_static/ide-platformio-codeblocks.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-platformio-codeblocks.png
+
+.. contents::
+
+Integration
+-----------
+
+Choose board ``ID`` 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 codeblocks --board <ID>
+
+    # For example, generate project for Arduino UNO
+    platformio init --ide codeblocks --board uno
+
+Then:
+
+1. Open this project via ``Menu: File > Open...``
+2. Add new files to ``src`` directory (``*.c, *.cpp, *.ino, etc.``) via
+   ``Menu: File > New > File...``
+3. Build project using ``Menu: Build > Build``
+4. Upload firmware using ``Menu: Build > Run``
+
+.. 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).

docs/ide/eclipse.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -24,25 +24,23 @@ with syntax highlighting, folding and hyperlink navigation, source code
 refactoring and code generation, visual debugging tools, including memory,
 registers, and disassembly viewers.
 
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
 Refer to the `CDT Documentation <https://eclipse.org/cdt/documentation.php>`_
 page for more detailed information.
 
+.. image:: ../_static/ide-platformio-eclipse.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-platformio-eclipse.png
+
 .. contents::
 
 Integration
 -----------
 
-Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+Choose board ``ID`` 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%
+    platformio init --ide eclipse --board <ID>
 
     # For example, generate project for Arduino UNO
     platformio init --ide eclipse --board uno
@@ -53,7 +51,7 @@ Then:
    ``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 using ``Menu: Project > Build Project`` or preconfigured
+3. Build project using ``Menu: Project > Build Project`` or pre-configured
    Make Targets (see screenshot below):
 
    + ``PlatformIO: Build`` - Build project without auto-uploading
@@ -61,39 +59,47 @@ Then:
    + ``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`.
+   + ``PlatformIO: Update platforms and libraries`` - Update installed
+     platforms and libraries via :ref:`cmd_update`
+   + ``PlatformIO: Rebuild C/C++ Project Index`` - Rebuild C/C++ Index for the Project.
+     Allows to fix code completion and code linting issues.
 
 If you have some problems with unresolved includes, defines, etc., then
 
-* Restart Eclipse IDE
-* Rebuild index using ``Menu: Project > C/C++ Index > Rebuild``.
+1. Rebuild PlatformIO Project Index:
+   ``PlatformIO: Rebuild C/C++ Project Index`` target
+2. Rebuild Eclipse Project Index: ``Menu: Project > C/C++ Index > Rebuild``
+3. Refresh Project, right click on the project ``Project > Refresh`` (F5) or
+   restart Eclipse IDE.
 
 .. 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).
+    after generating process wont be reflected in IDE. To fix it please run
+    ``PlatformIO: Rebuild C/C++ Project Index`` target and right click on the
+    project and ``Project > Refresh`` (F5).
+
+Live Integration
+----------------
+
+Eclipse Virtual IoT Meetup: `PlatformIO: a cross-platform IoT solution to build them all! <http://www.meetup.com/Virtual-IoT/events/229964142/>`_
+
+.. image:: ../_static/ide-eclipse-virtualiot.jpg
+    :target: https://www.youtube.com/watch?v=6t7UbX812Yw
 
 Articles / Manuals
 ------------------
 
+* May 05, 2016 - **Ivan Kravets, Ph.D. / Eclipse Virtual IoT Meetup** - `PlatformIO: a cross-platform IoT solution to build them all! <http://www.meetup.com/Virtual-IoT/events/229964142/>`_
 * 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://docs.platformio.org/en/latest/_static/ide-platformio-eclipse.png
-
 Examples
 --------
 
 "Blink" Project
 ^^^^^^^^^^^^^^^
 
-Source code of `Eclipse "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/eclipse>`_.
+Source code of `Eclipse "Blink" Project <https://github.com/platformio/platformio-examples/tree/develop/ide/eclipse>`_.

docs/ide/emacs.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,15 +19,12 @@ 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.
 
+.. image:: ../_static/ide-platformio-emacs.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-platformio-emacs.png
+
 .. contents::
 
 Integration
@@ -48,12 +45,12 @@ Code completion can optionally be provided by installing `irony-mode <https://gi
 Project Generator
 ^^^^^^^^^^^^^^^^^
 
-Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+Choose board ``ID`` 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%
+    platformio init --ide emacs --board <ID>
 
 
 There are 6 predefined targets for building.
@@ -69,10 +66,3 @@ There are 6 predefined targets for building.
     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,50 +0,0 @@
-..  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_energia:
-
-Energia
-=======
-
-The open-source `Energia Software (IDE) <http://energia.nu>`_
-makes it easy to write code and upload it to the board. It runs on *Windows,
-Mac OS X, and Linux*. The environment is written in *Java* and based on
-*Processing* and other open-source software.
-
-This software can be used with:
-
-* :ref:`platform_timsp430`
-* :ref:`platform_titiva`
-* :ref:`framework_energia`
-
-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
------------
-
-.. image:: ../_static/ide-platformio-energia.png
-    :target: http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides

docs/ide/netbeans.rst

@@ -0,0 +1,64 @@
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
+    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_netbeans:
+
+NetBeans
+========
+
+NetBeans is a Java-based integrated development environment (IDE). It provides
+out-of-the-box code analyzers and editors for working with the latest Java 8
+technologies--Java SE 8, Java SE Embedded 8, and Java ME Embedded 8. The IDE
+also has a range of new tools for HTML5/JavaScript, in particular for Node.js,
+KnockoutJS, and AngularJS; enhancements that further improve its support for
+Maven and Java EE with PrimeFaces; and improvements to PHP and C/C++ support.
+
+NetBeans IDE can be downloaded from `here <https://netbeans.org/downloads/>`_.
+Just make sure you download the C/C++ version (or if you already use NetBeans,
+install the C/C++ development plugins).
+
+.. image:: ../_static/ide-platformio-netbeans.png
+    :target: http://docs.platformio.org/en/stable/_images/ide-platformio-netbeans.png
+
+.. contents::
+
+Integration
+-----------
+
+Choose board ``ID`` 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 netbeans --board <ID>
+
+    # For example, generate project for Arduino UNO
+    platformio init --ide netbeans --board uno
+
+Then:
+
+1. Open this project via ``Menu: File > Open Project...``
+2. Add new files to ``src`` directory (``*.c, *.cpp, *.ino, etc.``) via
+   right-click on ``src`` folder in the "Projects" pane
+3. Build project using ``Menu: Run > Build Project``
+4. Upload firmware using ``Menu: Run > Run Project``
+
+.. 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
+------------------
+
+* Feb 22, 2016 - **Grzegorz Hołdys** - `How to Integrate PlatformIO with Netbeans <http://www.instructables.com/id/How-to-Integrate-PlatformIO-With-Netbeans/>`_
+
+See the full list with :ref:`articles`.

docs/ide/qtcreator.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -16,14 +16,12 @@ Qt Creator
 
 The `Qt Creator <https://github.com/qtproject/qt-creator>`_ is an open source cross-platform integrated development environment. The editor includes such features as syntax highlighting for various languages, project manager, integrated version control systems, rapid code navigation tools and code autocompletion.
 
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
 Refer to the `Qt-creator Manual <http://doc.qt.io/qtcreator/>`_
 page for more detailed information.
 
+.. image:: ../_static/ide-platformio-qtcreator-7.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-platformio-qtcreator-7.png
+
 .. contents::
 
 Integration
@@ -37,12 +35,12 @@ Integration
 Project Generator
 ^^^^^^^^^^^^^^^^^
 
-Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+Choose board ``ID`` 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%
+    platformio init --ide qtcreator --board <ID>
 
     # For example, generate project for Arduino UNO
     platformio init --ide qtcreator --board uno
@@ -85,7 +83,7 @@ Then:
 8. Build project: ``Menu: Build > Build All``.
 
 .. image:: ../_static/ide-platformio-qtcreator-3.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-3.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-platformio-qtcreator-3.png
 
 .. warning::
     The libraries which are added, installed or used in the project
@@ -101,16 +99,16 @@ Setup New Project
 First of all, let's create new project from Qt Creator Start Page: ``New Project`` or using ``Menu: File > New File or Project``, then select project with ``Empty Qt Project`` type (``Other Project > Empty Qt Project``), fill ``Name``, ``Create in``.
 
 .. image:: ../_static/ide-platformio-qtcreator-1.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-1.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-platformio-qtcreator-1.png
 
 On the next steps select any available kit and click Finish button.
 
 .. image:: ../_static/ide-platformio-qtcreator-2.png
 
-Secondly, we need to delete default build and clean steps and configure project with PlatformIO source code builder (click on Projects label on left menu or ``Ctrl+5`` shortcut):
+Secondly, we need to delete default build and clean steps and configure project with PlatformIO Build System (click on Projects label on left menu or ``Ctrl+5`` shortcut):
 
 .. image:: ../_static/ide-platformio-qtcreator-3.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-3.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-platformio-qtcreator-3.png
 
 Thirdly, change project file by adding path to directories with header files. Please edit project file to match the following contents:
 
@@ -127,7 +125,7 @@ Thirdly, change project file by adding path to directories with header files. Pl
     INCLUDEPATH += "$${HOMEDIR}/.platformio/packages/toolchain-atmelavr/avr/include"
 
 .. image:: ../_static/ide-platformio-qtcreator-4.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-4.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-platformio-qtcreator-4.png
 
 First program in Qt Creator
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -138,7 +136,7 @@ Simple "Blink" project will consist from two files:
 Let's create new text file named ``main.c`` using ``Menu: New File or Project > General > Text File``:
 
 .. image:: ../_static/ide-platformio-qtcreator-5.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-5.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-platformio-qtcreator-5.png
 
 Copy the source code which is described below to file ``main.c``.
 
@@ -163,21 +161,20 @@ Copy the source code which is described below to file ``main.c``.
 3. Locate the project configuration file named ``platformio.ini`` at the root of the project directory and open it.
 
 .. image:: ../_static/ide-platformio-qtcreator-6.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-6.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-platformio-qtcreator-6.png
 
 Edit the content to match the code described below.
 
-.. code-block:: none
+.. code-block:: ini
 
-    #
-    # Project Configuration File
-    #
-    # A detailed documentation with the EXAMPLES is located here:
-    # http://docs.platformio.org/en/latest/projectconf.html
-    #
-
-    # A sign `#` at the beginning of the line indicates a comment
-    # Comment lines are ignored.
+    ; PlatformIO Project Configuration File
+    ;
+    ;   Build options: build flags, source filter, extra scripting
+    ;   Upload options: custom port, speed and extra flags
+    ;   Library options: dependencies, extra library storages
+    ;
+    ; Please visit documentation for the other options and examples
+    ; http://docs.platformio.org/en/stable/projectconf.html
 
     [env:arduino_uno]
     platform = atmelavr
@@ -189,16 +186,10 @@ Conclusion
 
 Taking everything into account, we can build project with shortcut ``Ctrl+Shift+B`` or using ``Menu: Build > Build All``.
 
-Screenshot
-----------
-
-.. image:: ../_static/ide-platformio-qtcreator-7.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-7.png
-
 Examples
 --------
 
 "Blink" Project
 ^^^^^^^^^^^^^^^
 
-Source code of `Qt Creator "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/qtcreator>`_.
+Source code of `Qt Creator "Blink" Project <https://github.com/platformio/platformio-examples/tree/develop/ide/qtcreator>`_.

docs/ide/sublimetext.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -16,28 +16,38 @@ Sublime Text
 
 The `Sublime Text <http://www.sublimetext.com/>`_ is a cross-platform text and source code editor, with a Python application programming interface (API). Sublime Text is proprietary software. Its functionality is extendable with plugins. Most of the extending packages have free-software licenses and are community-built and maintained. Sublime Text lacks graphical setting dialogues and is entirely configured by editing text files.
 
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
 Refer to the `Sublime Text Documentation <http://docs.sublimetext.info/en/latest>`_
 page for more detailed information.
 
+.. image:: ../_static/ide-sublime-text-deviot.gif
+    :target: https://github.com/gepd/Deviot
+
 .. contents::
 
 Integration
 -----------
 
+Deviot Plugin
+^^^^^^^^^^^^^
+
+We are glad to inform you about awesome Sublime Text plugin for IoT development
+named `Deviot <https://github.com/gepd/Deviot>`_. It is based on
+PlatformIO CLI and will automatically install it for you. Please visit `official
+Deviot page <https://github.com/gepd/Deviot>`_ for the further installation
+steps and documentation.
+
+.. image:: ../_static/ide-sublime-text-deviot.gif
+    :target: https://github.com/gepd/Deviot
+
 Project Generator
 ^^^^^^^^^^^^^^^^^
 
-Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+Choose board ``ID`` 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%
+    platformio init --ide sublimetext --board <ID>
 
     # For example, generate project for Arduino UNO
     platformio init --ide sublimetext --board uno
@@ -154,17 +164,16 @@ Let's create new file named ``main.c`` using ``Menu: File > New File`` or shortc
 2. Project Configuration File named ``platformio.ini`` must be located in the project root directory.
 Copy the source code which is described below to it.
 
-.. code-block:: none
+.. code-block:: ini
 
-    #
-    # Project Configuration File
-    #
-    # A detailed documentation with the EXAMPLES is located here:
-    # http://docs.platformio.org/en/latest/projectconf.html
-    #
-
-    # A sign `#` at the beginning of the line indicates a comment
-    # Comment lines are ignored.
+    ; PlatformIO Project Configuration File
+    ;
+    ;   Build options: build flags, source filter, extra scripting
+    ;   Upload options: custom port, speed and extra flags
+    ;   Library options: dependencies, extra library storages
+    ;
+    ; Please visit documentation for the other options and examples
+    ; http://docs.platformio.org/en/stable/projectconf.html
 
     [env:arduino_uno]
     platform = atmelavr
@@ -176,15 +185,10 @@ Conclusion
 
 Taking everything into account, we can open project directory in Sublime Text using ``Menu: File > Open Folder`` and build it with shortcut ``Ctrl+B`` (Windows/Linux) or ``Cmd+B`` (Mac), clean project with shortcut ``F11`` and upload firmware to target with shortcut ``F12``.
 
-Screenshot
-----------
-
-.. image:: ../_static/ide-sublime-text-platformio-newproject-5.png
-
 Examples
 --------
 
 "Blink" Project
 ^^^^^^^^^^^^^^^
 
-Source code of `Sublime Text "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/sublimetext>`_.
+Source code of `Sublime Text "Blink" Project <https://github.com/platformio/platformio-examples/tree/develop/ide/sublimetext>`_.

docs/ide/vim.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,10 +18,7 @@ VIM
 editor. Vim is designed for use both from a command-line interface and as a
 standalone application in a graphical user interface.
 
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
+.. image:: ../_static/ide-platformio-vim.png
 
 .. contents::
 
@@ -90,8 +87,3 @@ 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
-----------
-
-.. image:: ../_static/ide-platformio-vim.png

docs/ide/visualstudio.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -16,14 +16,12 @@ Visual Studio
 
 The `Microsoft Visual Studio (Free) <http://visualstudio.com/free>`_ is an integrated development environment (IDE) from Microsoft. Visual Studio includes a code editor supporting IntelliSense (the code completion component) as well as code refactoring.
 
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
 Refer to the `Visual Studio Documentation <https://msdn.microsoft.com/library/vstudio>`_
 page for more detailed information.
 
+.. image:: ../_static/ide-vs-platformio-newproject-8.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-vs-platformio-newproject-8.png
+
 .. contents::
 
 Integration
@@ -37,12 +35,12 @@ Integration
 Project Generator
 ^^^^^^^^^^^^^^^^^
 
-Choose board ``type`` using :ref:`cmd_boards` or `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
+Choose board ``ID`` 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%
+    platformio init --ide sublimetext --board <ID>
 
     # For example, generate project for Arduino UNO
     platformio init --ide visualstudio --board uno
@@ -69,7 +67,7 @@ First of all, let's create new project from Visual Studio Start Page: ``Start >
 
 .. image:: ../_static/ide-vs-platformio-newproject.png
 
-Secondly, we need to configure project with PlatformIO source code builder:
+Secondly, we need to configure project with PlatformIO Build System:
 
 .. image:: ../_static/ide-vs-platformio-newproject-2.png
 
@@ -95,14 +93,14 @@ First program in Visual Studio
 
 Simple "Blink" project will consist from two files:
 
-1. Main "C" source file named ``main.c`` must be located in the ``src`` directory.
-Let's create new file named ``main.c`` using ``Menu: File > New File`` or shortcut ``Ctrl+N``:
+1. Main "C++" source file named ``main.cpp`` must be located in the ``src`` directory.
+Let's create new file named ``main.cpp`` using ``Menu: File > New File`` or shortcut ``Ctrl+N``:
 
 .. image:: ../_static/ide-vs-platformio-newproject-6.png
 
-Copy the source code which is described below to file ``main.c``.
+Copy the source code which is described below to file ``main.cpp``.
 
-.. code-block:: c
+.. code-block:: cpp
 
     #include "Arduino.h"
     #define WLED    13  // Most Arduino boards already have an LED attached to pin 13 on the board itself
@@ -126,17 +124,16 @@ Copy the source code which is described below to file ``main.c``.
 
 Copy the source code which is described below to it.
 
-.. code-block:: none
+.. code-block:: ini
 
-    #
-    # Project Configuration File
-    #
-    # A detailed documentation with the EXAMPLES is located here:
-    # http://docs.platformio.org/en/latest/projectconf.html
-    #
-
-    # A sign `#` at the beginning of the line indicates a comment
-    # Comment lines are ignored.
+    ; PlatformIO Project Configuration File
+    ;
+    ;   Build options: build flags, source filter, extra scripting
+    ;   Upload options: custom port, speed and extra flags
+    ;   Library options: dependencies, extra library storages
+    ;
+    ; Please visit documentation for the other options and examples
+    ; http://docs.platformio.org/en/stable/projectconf.html
 
     [env:arduino_uno]
     platform = atmelavr
@@ -149,16 +146,32 @@ Conclusion
 
 Taking everything into account, we can build project with shortcut ``Ctrl+Shift+B`` or using ``Menu: Build > Build Solution``.
 
-Screenshot
-----------
-
-.. image:: ../_static/ide-vs-platformio-newproject-8.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-vs-platformio-newproject-8.png
-
 Examples
 --------
 
 "Blink" Project
 ^^^^^^^^^^^^^^^
 
-Source code of `Visual Studio "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/visualstudio>`_.
+Source code of `Visual Studio "Blink" Project <https://github.com/platformio/platformio-examples/tree/develop/ide/visualstudio>`_.
+
+Known issues
+------------
+
+IntelliSense Errors
+^^^^^^^^^^^^^^^^^^^
+
+VS Studio does not allow to specify for project other toolchain which will
+be used by IntelliSense. In this case, IntelliSense does not understand
+GCC-specific definitions.
+
+However, these errors does not have any influence on PlatformIO Build
+System. It means that you can ignore them and rely on PlatformIO Build System
+messages which will be shown in output console after build.
+
+Nevertheless, you can provide an IntelliSense-friendly definition of problematic
+GCC constructs and make sure that the GCC will ignore such definitions or
+disable IntelliSense error reporting at all.
+See details in `issue #543 <https://github.com/platformio/platformio/issues/543>`_
+
+.. image:: ../_static/ide-vs-platformio-newproject-9.png
+    :target: http://docs.platformio.org/en/stable/_static/ide-vs-platformio-newproject-9.png

docs/index.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -12,9 +12,14 @@
 PlatformIO is an open source ecosystem for IoT development
 ==========================================================
 
-**Cross-platform code builder and library manager. Continuous and IDE
-integration. Arduino and MBED compatible. Ready for Cloud compiling.**
+**Cross-platform build system and library manager. Continuous and IDE
+integration. Arduino, ESP8266 and ARM mbed compatible.**
 
+* **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 favorite 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)
@@ -30,17 +35,19 @@ integration. Arduino and MBED compatible. Ready for Cloud compiling.**
 Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed,
 libOpenCM3, etc.*
 
-* `Website <http://platformio.org>`_
-* `Web 2.0 Library Search <http://platformio.org/#!/lib>`_ |
-  `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
-* `Project Examples <https://github.com/platformio/platformio/tree/develop/examples>`_
+* `Home Page <http://platformio.org>`_
+* `PlatformIO Plus and professional solutions <https://pioplus.com>`_
+* :ref:`ide_atom`
+* `Library Search and Registry <http://platformio.org/lib>`_ |
+  `Embedded Boards Explorer <http://platformio.org/boards>`_
+* `Project Examples <https://github.com/platformio/platformio-examples/tree/develop>`_
 * `Source Code <https://github.com/platformio/platformio>`_ |
   `Issues <https://github.com/platformio/platformio/issues>`_
 * `Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
   `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>`_ |
+  `Forums <https://community.platformio.org>`_
 
 Embedded Development. *Easier Than Ever.*
 -----------------------------------------
@@ -49,12 +56,11 @@ Embedded Development. *Easier Than Ever.*
 * :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
+* Built-in :ref:`Serial Port Monitor <cmd_device_monitor>` and
   configurable build :ref:`-flags/-options <projectconf_build_flags>`
-* Pre-built toolchains, :ref:`frameworks` for the
-  :ref:`Development Platforms <platforms>`
+* Pre-built toolchains, :ref:`frameworks` for the :ref:`platforms`
 
-Smart Code Builder. *Fast and Reliable.*
+Smart Build System. *Fast and Reliable.*
 ----------------------------------------
 
 * Reliable, automatic dependency analysis and detection of build changes
@@ -66,22 +72,27 @@ The Missing Library Manager. *It's here!*
 -----------------------------------------
 
 * Friendly Command-Line Interface
-* Modern `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
+* Modern `Web 2.0 Library Search <http://platformio.org/lib>`_
 * Library dependency management
 * Automatic library updating
 * It runs on Windows, Mac OS X, and Linux (+ARM).
 
 For further details, please refer to
-:ref:`What is PlatformIO? How does it work? <faq_what_is_platformio>`
+:ref:`What is PlatformIO? How does it work? <what_is_pio>`
 
 Contents
 --------
 
+.. toctree::
+    :maxdepth: 2
+
+    what-is-platformio
+    demo
+
 .. toctree::
     :caption: Getting Started
     :maxdepth: 2
 
-    demo
     installation
     quickstart
     userguide/index
@@ -97,8 +108,16 @@ Contents
     :caption: Instruments
     :maxdepth: 3
 
-    Platforms & Boards <platforms/index>
+    platforms/index
+    platforms/embedded_boards
     frameworks/index
+    platforms/custom_platform_and_board
+
+.. toctree::
+    :caption: PlatformIO Plus
+    :maxdepth: 3
+
+    plus/unit-testing
 
 .. toctree::
     :caption: Library Manager
@@ -106,6 +125,7 @@ Contents
 
     Quickstart <librarymanager/index>
     User Guide <userguide/lib/index.rst>
+    librarymanager/ldf
     librarymanager/config
     librarymanager/creating
 
@@ -123,3 +143,5 @@ Contents
     articles
     FAQ <faq>
     history
+    migration
+

docs/installation.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,19 +14,14 @@
 Installation
 ============
 
+.. include:: /ide/_platformio_ide_extra.rst
+
 **PlatformIO** is written in `Python <https://www.python.org/downloads/>`_ and
 works on Mac OS X, Linux, Windows OS and *ARM*-based credit-card sized
 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
@@ -41,7 +36,10 @@ System requirements
         **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.
+        "Customize" stage, otherwise Python Package Manager ``pip`` command
+        will not be available.
+
+        .. image:: _static/python-installer-add-path.png
 
 :Terminal Application:
 
@@ -53,13 +51,22 @@ System requirements
 Installation Methods
 --------------------
 
+.. note::
+    You don't need to install PlatformIO CLI if you are going to use
+    :ref:`ide_atom`. PlatformIO CLI is built into PlatformIO IDE and you will be
+    able to use it within PlatformIO IDE Terminal.
+
+
 Please *choose ONE of* the following methods:
 
-a) Python Package Manager
-~~~~~~~~~~~~~~~~~~~~~~~~~
+.. contents::
+    :local:
+
+Python Package Manager
+~~~~~~~~~~~~~~~~~~~~~~
 
 The latest stable version of PlatformIO may be installed or upgraded via
-`pip <https://pip.pypa.io>`_ as follows:
+Python Package Manager (`pip <https://pip.pypa.io>`_) as follows:
 
 .. code-block:: bash
 
@@ -80,8 +87,8 @@ a few options here:
 
 .. _installation_installer_script:
 
-b) Installer Script
-~~~~~~~~~~~~~~~~~~~
+Installer Script
+~~~~~~~~~~~~~~~~
 
 Super-Quick (Mac / Linux)
 '''''''''''''''''''''''''
@@ -120,8 +127,19 @@ On *Windows OS* it may look like:
     # run it
     C:\Python27\python.exe get-platformio.py
 
-c) Full Guide
-~~~~~~~~~~~~~
+
+Mac OS X Homebrew
+~~~~~~~~~~~~~~~~~
+
+The latest stable version of PlatformIO may be installed or upgraded via
+Mac OS X Homebrew Packages Manager (`brew <http://brew.sh/>`_) as follows:
+
+.. code-block:: bash
+
+    brew install platformio
+
+Full Guide
+~~~~~~~~~~
 
 1. Check a ``python`` version (only 2.6-2.7 is supported):
 
@@ -149,8 +167,13 @@ For upgrading ``platformio`` to the latest version:
 
     pip install -U platformio
 
-d) Development Version
-~~~~~~~~~~~~~~~~~~~~~~
+Development Version
+~~~~~~~~~~~~~~~~~~~
+
+.. warning::
+    If you use :ref:`ide_atom`, please enable development version via
+    ``Menu PlatformIO: Settings > PlatformIO IDE > Use development version of
+    PlatformIO``.
 
 Install the latest PlatformIO from the ``develop`` branch:
 
@@ -177,11 +200,6 @@ To revert to the latest stable version
 Troubleshooting
 ---------------
 
-.. warning::
-    If you are going to run *PlatformIO* from **subprocess**, you
-    :ref:`MUST DISABLE <faq_troubleshooting_pioblocksprompt>` all prompts.
-    It will allow you to avoid blocking.
-
 .. note::
     **Linux OS**: Don't forget to install "udev" rules file
     `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).

docs/librarymanager/config.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,10 +22,11 @@ to keep project in own structure and define:
 * examples list
 * compatible frameworks and platforms
 * library dependencies
+* advanced build settings
 
 PlatformIO Library Crawler uses ``library.json`` manifest to extract
-source code from developer's location and keeps cleaned library in own
-Library Storage.
+source code from developer's location and keeps a cleaned library in own
+Library Registry.
 
 A data in ``library.json`` should be represented
 in `JSON-style <http://en.wikipedia.org/wiki/JSON>`_ via
@@ -138,10 +139,10 @@ Examples:
 
 *Required* if :ref:`libjson_downloadurl` field is not defined | Type: ``Object``
 
-The repository in which the source code can be found. The field consists for the
+The repository in which the source code can be found. The field consists of the
 next items:
 
-* ``type``
+* ``type`` the only "git", "hg" or "svn" are supported
 * ``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`.
@@ -201,7 +202,7 @@ dash. `Semantic Versioning <http://semver.org>`_ IS RECOMMENDED.
     ``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
+    version and make appropriate tag in the :ref:`libjson_repository`. In other
     case, users will receive updates for library with each new commit to
     :ref:`libjson_repository`.
 
@@ -221,6 +222,21 @@ Example:
     },
     "version": "1.0.0"
 
+
+``license``
+-----------
+
+*Optional* | Type: ``String``
+
+A license of the library. You can check
+`the full list of SPDX license IDs <https://spdx.org/licenses/>`_. Ideally you
+should pick one that is `OSI <https://opensource.org/licenses/alphabetical>`_
+approved.
+
+.. code-block:: javascript
+
+    "license": "Apache-2.0"
+
 .. _libjson_downloadurl:
 
 ``downloadUrl``
@@ -246,27 +262,40 @@ Example with fixed release/tag on GitHub:
 
 See more ``library.json`` :ref:`library_creating_examples`.
 
-.. _libjson_url:
-
-``url``
--------
+``homepage``
+------------
 
 *Optional* | Type: ``String`` | Max. Length: 255
 
 Home page of library (if is different from :ref:`libjson_repository` url).
 
 
-.. _libjson_include:
+.. _libjson_export:
+
+``export``
+----------
+
+*Optional* | Type: ``Object``
+
+Explain PlatformIO Library Crawler which content from the repository/archive
+should be exported as "source code" of the library. This option is useful if
+need to exclude extra data (test code, docs, images, PDFs, etc). It allows to
+reduce size of the final archive.
+
+Possible options:
+
+.. contents::
+    :local:
 
 ``include``
------------
+~~~~~~~~~~~
 
 *Optional* | Type: ``String`` or ``Array`` |
 `Glob Pattern <http://en.wikipedia.org/wiki/Glob_(programming)>`_
 
-If :ref:`libjson_include` field is a type of ``String``, then
-|PIOAPICR| will recognize it like a "relative path inside
-repository/archive to library source code". See example below where the only
+If ``include`` field is a type of ``String``, then |PIOAPICR| will recognize
+it like a "relative path inside repository/archive to library source code".
+See example below where the only
 source code from the relative directory ``LibrarySourceCodeHere`` will be
 included.
 
@@ -274,21 +303,23 @@ included.
 
     "include": "some/child/dir/LibrarySourceCodeHere"
 
-If :ref:`libjson_include` field is a type of ``Array``, then
-|PIOAPICR| firstly will apply :ref:`libjson_exclude` filter and
-then include only directories/files which match with :ref:`libjson_include`
-patterns.
+If ``include`` field is a type of ``Array``, then |PIOAPICR| firstly will
+apply ``exclude`` filter and then include only directories/files
+which match with ``include`` patterns.
 
 Example:
 
 .. code-block:: javascript
 
-    "include":
-    [
-        "dir/*.[ch]pp",
-        "dir/examples/*",
-        "*/*/*.h"
-    ]
+    "export": {
+        "include":
+        [
+            "dir/*.[ch]pp",
+            "dir/examples/*",
+            "*/*/*.h"
+        ]
+    }
+
 
 Pattern	Meaning
 
@@ -308,16 +339,14 @@ Pattern	Meaning
 
 See more ``library.json`` :ref:`library_creating_examples`.
 
-.. _libjson_exclude:
 
 ``exclude``
------------
+~~~~~~~~~~~
 
 *Optional* | Type: ``String`` or ``Array`` |
 `Glob Pattern <http://en.wikipedia.org/wiki/Glob_(programming)>`_
 
-Exclude the directories and files which match with :ref:`libjson_exclude`
-patterns.
+Exclude the directories and files which match with ``exclude`` patterns.
 
 .. _libjson_frameworks:
 
@@ -367,10 +396,26 @@ A list of dependent libraries. They will be installed automatically with
 Allowed requirements for dependent library:
 
 * ``name`` | Type: ``String``
+* ``version`` | Type: ``String``
 * ``authors`` | Type: ``String`` or ``Array``
 * ``frameworks`` | Type: ``String`` or ``Array``
 * ``platforms`` | Type: ``String`` or ``Array``
 
+The ``version`` supports `Semantic Versioning <http://semver.org>`_ (
+``<major>.<minor>.<patch>``) and can take any of the following forms:
+
+* ``0.1.2`` - an exact version number. Use only this exact version
+* ``^0.1.2`` - any compatible version (exact version for ``0.x.x`` versions
+* ``~0.1.2`` - any version with the same major and minor versions, and an
+  equal or greater patch version
+* ``>0.1.2`` - any version greater than ``0.1.2``. ``>=``, ``<``, and ``<=``
+  are also possible
+* ``>0.1.0,!=0.2.0,<0.3.0`` - any version greater than ``0.1.0``, not equal to
+  ``0.2.0`` and less than ``0.3.0``
+
+The rest possible values including VCS repository URLs are documented in
+:ref:`cmd_lib_install` command.
+
 Example:
 
 .. code-block:: javascript
@@ -387,17 +432,30 @@ Example:
         },
         {
             "name": "Library-Bar",
-            "frameworks": "FrameworkFoo, FrameworkBar"
+            "version": "~1.2.3"
+        },
+        {
+            "name": "lib-from-repo",
+            "version": "https://github.com/user/package.git#1.2.3"
         }
     ]
 
+A short definition of dependencies is allowed:
+
+.. code-block:: javascript
+
+    "dependencies": {
+        "mylib": "1.2.3",
+        "lib-from-repo": "githubuser/package"
+    }
+
 
 See more ``library.json`` :ref:`library_creating_examples`.
 
 .. _libjson_examples:
 
 ``examples``
-----------------
+------------
 
 *Optional* | Type: ``String`` or ``Array`` |
 `Glob Pattern <http://en.wikipedia.org/wiki/Glob_(programming)>`_
@@ -407,9 +465,141 @@ A list of example patterns. This field is predefined with default value:
 .. code-block:: javascript
 
     "examples": [
+        "[Ee]xamples/*.c",
+        "[Ee]xamples/*.cpp",
+        "[Ee]xamples/*.ino",
+        "[Ee]xamples/*.pde",
         "[Ee]xamples/*/*.c",
         "[Ee]xamples/*/*.cpp",
-        "[Ee]xamples/*/*.h",
         "[Ee]xamples/*/*.ino",
-        "[Ee]xamples/*/*.pde"
+        "[Ee]xamples/*/*.pde",
+        "[Ee]xamples/*/*/*.c",
+        "[Ee]xamples/*/*/*.cpp",
+        "[Ee]xamples/*/*/*.ino",
+        "[Ee]xamples/*/*/*.pde"
     ]
+
+
+.. _libjson_build:
+
+``build``
+---------
+
+*Optional* | Type: ``Object``
+
+Specify advanced settings, options and flags for the build system. Possible
+options:
+
+.. contents::
+    :local:
+
+``flags``
+~~~~~~~~~
+
+*Optional* | Type: ``String`` or ``Array``
+
+Extra flags to control preprocessing, compilation, assembly and linking
+processes. More details :ref:`projectconf_build_flags`.
+
+``unflags``
+~~~~~~~~~~~
+
+*Optional* | Type: ``String`` or ``Array``
+
+Remove base/initial flags which were set by development platform. More
+details :ref:`projectconf_build_unflags`.
+
+``srcFilter``
+~~~~~~~~~~~~~
+
+*Optional* | Type: ``String`` or ``Array``
+
+Specify which source files should be included/excluded from build process.
+More details :ref:`projectconf_src_filter`.
+
+``extraScript``
+~~~~~~~~~~~~~~~
+
+*Optional* | Type: ``String``
+
+Launch extra script before build process.
+More details :ref:`projectconf_extra_script`.
+
+``libArchive``
+~~~~~~~~~~~~~~
+
+*Optional* | Type: ``Boolean``
+
+Archive object files to Static Library. This is default behavior of PlatformIO
+Build System (``"libArchive": true``).
+
+``libLDFMode``
+~~~~~~~~~~~~~~
+
+*Optional* | Type: ``Integer``
+
+Specify Library Dependency Finder Mode. See :ref:`ldf_mode` for details.
+
+**Examples**
+
+1. Custom macros/defines
+
+.. code-block:: javascript
+
+    "build": {
+        "flags": "-D MYLIB_REV=0.1.2 -DRELEASE"
+    }
+
+2. Extra includes for C preprocessor
+
+.. code-block:: javascript
+
+    "build": {
+        "flags": [
+            "-I inc",
+            "-I inc/target_x13"
+        ]
+    }
+
+3. Force to use ``C99`` standard instead of ``C11``
+
+.. code-block:: javascript
+
+    "build": {
+        "unflags": "-std=gnu++11",
+        "flags": "-std=c99"
+    }
+
+4. Build source files (``c, cpp, h``) at the top level of the library
+
+.. code-block:: javascript
+
+    "build": {
+        "srcFilter": [
+            "+<*.c>",
+            "+<*.cpp>",
+            "+<*.h>"
+        ]
+    }
+
+
+5. Extend PlatformIO Build System with own extra script
+
+.. code-block:: javascript
+
+    "build": {
+        "extraScript": "generate_headers.py"
+    }
+
+``generate_headers.py``
+
+.. code-block:: python
+
+    Import('env')
+    # print env.Dump()
+    env.Append(
+        CPPDEFINES=["HELLO=WORLD", "TAG=1.2.3", "DEBUG"],
+        CPPPATH=["inc", "inc/devices"]
+    )
+
+    # some python code that generates header files "on-the-fly"

docs/librarymanager/creating.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,6 +20,9 @@ source code structure. The only one requirement is library's manifest file -
 :ref:`library_config`. It can be located inside your library or in the another
 location where |PIOAPICR| will have *HTTP* access.
 
+Updates to existing libraries are done every 24 hours. In case a more urgent
+update is required, you can post a request on PlatformIO `community <https://community.platformio.org/>`_.
+
 .. contents::
 
 Source Code Location
@@ -29,9 +32,8 @@ There are a several ways how to share your library with the whole world
 (see `examples <https://github.com/platformio/platformio-libmirror/tree/master/configs>`_).
 
 You can hold a lot of libraries (split into separated folders) inside one of
-the repository/archive. In this case please use :ref:`libjson_include`
-field to specify the relative path to your library's source code.
-
+the repository/archive. In this case, you need to specify ``include`` option of
+:ref:`libjson_export` field to relative path to your library's source code.
 
 At GitHub
 ^^^^^^^^^
@@ -129,7 +131,9 @@ of **required** fields in the :ref:`library_config` will look like:
         },
         "version": "2.2",
         "downloadUrl": "http://www.pjrc.com/teensy/arduino_libraries/OneWire.zip",
-        "include": "OneWire",
+        "export": {
+            "include": "OneWire"
+        },
         "frameworks": "arduino",
         "platforms": "atmelavr"
     }
@@ -152,6 +156,12 @@ to :ref:`install <cmd_lib_install>` it.
 Examples
 --------
 
-* `GitHub + fixed release <http://platformio.org/#!/lib/show/552/ACNoblex>`_
-* `Dependencies by author and framework <http://platformio.org/#!/lib/show/3/PID-AutoTune>`_
+Command:
+
+.. code-block:: bash
+
+    $ platformio lib register http://my.example.com/library.json
+
+* `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-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,13 +14,50 @@
 Library Manager
 ===============
 
-*PlatformIO Library Manager* allows you to organize external embedded libraries.
-You can search for new libraries via
+*PlatformIO Library Manager* is a tool for managing libraries of
+`PlatformIO Registry <http://platformio.org/lib>`__ and VCS repositories (Git,
+Hg, SVN). It makes it exceedingly simple to find, install and keep libraries
+up-to-date. PlatformIO Library Manager supports
+`Semantic Versioning <http://semver.org>`_ and its rules.
 
-* :ref:`Command Line interface <cmd_lib_search>`
-* `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
+There 2 options how to find library:
 
-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.
+* :ref:`Command Line Interface <cmd_lib_search>`
+* `Web-based Library Search <http://platformio.org/lib>`__
+
+*PlatformIO Library Manager* allows to manage different library storages using
+:option:`platformio lib --global` or  :option:`platformio lib --storage-dir`
+options.
+
+Project dependencies
+--------------------
+
+*PlatformIO Library Manager* allows to specify project dependencies
+(:ref:`projectconf_lib_deps`) that will be installed automatically per project
+before environment processing. You do not need to install libraries manually.
+The only one simple step is to define dependencies in :ref:`projectconf`.
+You can use library ID, Name or even repository URL. For example,
+
+.. code-block:: ini
+
+  [env:myenv]
+  platform = ...
+  framework = ...
+  board = ...
+  lib_deps =
+    13
+    PubSubClient
+    Json@~5.6,!=5.4
+    https://github.com/gioblu/PJON.git@v2.0
+    https://github.com/me-no-dev/ESPAsyncTCP.git
+    https://github.com/adafruit/DHT-sensor-library/archive/master.zip
+
+Please follow to :ref:`cmd_lib_install` for detailed documentation about
+possible values.
+
+.. warning::
+  If some libraries are not visible in :ref:`ide_atom` and Code Completion or
+  Code Linting does not work properly, please perform  ``Menu: PlatformIO >
+  Rebuild C/C++ Project Index (Autocomplete, Linter)``
 
 .. image:: ../_static/platformio-demo-lib.gif

docs/librarymanager/ldf.rst

@@ -0,0 +1,167 @@
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
+    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.
+
+.. _ldf:
+
+Library Dependency Finder (LDF)
+===============================
+
+.. versionadded:: 3.0
+
+Library Dependency Finder is a core part of PlatformIO Build System that
+operates with the C/C++ source files and looks for ``#include ...``
+directives.
+
+In spite of the fact that Library Dependency Finder is written in pure Python,
+it interprets (emulates) :ref:`ldf_c_cond_syntax` (``#ifdef``, ``if``, ``defined``,
+``else``, and ``elif``) without calling ``gcc -E``. This approach allows
+significantly reduce total compilation time.
+
+Library Dependency Finder has controls that can be set up in :ref:`projectconf`:
+
+.. hlist::
+    :columns: 3
+
+    * :ref:`projectconf_lib_deps`
+    * :ref:`projectconf_lib_extra_dirs`
+    * :ref:`projectconf_lib_force`
+    * :ref:`projectconf_lib_ignore`
+    * :ref:`projectconf_lib_compat_mode`
+    * :ref:`projectconf_lib_ldf_mode`
+
+-----------
+
+.. contents::
+
+.. _ldf_storage:
+
+Storage
+-------
+
+There are different storages where Library Dependency Finder looks for
+libraries. These storages (folders) have priority and LDF operates in the next
+order:
+
+1. :ref:`projectconf_lib_extra_dirs` - extra storages per build environment
+2. :ref:`projectconf_pio_lib_dir` - own/private library storage per project
+3. :ref:`projectconf_pio_libdeps_dir` - project dependencies storage used by
+   :ref:`librarymanager`
+4. ":ref:`projectconf_pio_home_dir`/lib" - global storage per all projects.
+
+.. _ldf_mode:
+
+Dependency Finder Mode
+----------------------
+
+Library Dependency Finder starts work from analyzing source files of the
+project (:ref:`projectconf_pio_src_dir`) and can work in the next modes:
+
+* ``0`` - "manual mode", does not process source files of a project and
+  dependencies. Builds only the libraries that are specified in
+  manifests (:ref:`library_config`, ``module.json``) or in the :ref:`projectconf`.
+* ``1`` - **default** - parses ALL C/C++ source code of the project and follows
+  only by nested includes (``#include ...``, chain...) from the libraries.
+* ``2`` - parses ALL C/C++ source code of the project and parses
+  ALL C/C++ source code of the each found dependency (recursively).
+
+This mode can be changed using :ref:`projectconf_lib_ldf_mode` option in
+:ref:`projectconf`.
+
+A difference between ``1`` and ``2`` modes. For example, there are 2 libraries:
+
+* Library "Foo" with files:
+
+  - ``Foo/foo.h``
+  - ``Foo/foo.cpp``
+
+* Library "Bar" with files:
+
+  - ``Bar/bar.h``
+  - ``Bar/bar.cpp``
+
+:Case 1:
+
+    * ``lib_ldf_mode = 1``
+    * ``Foo/foo.h`` depends on "Bar" library (contains ``#include <bar.h>``)
+    * ``#include <foo.h>`` is located in one of the project source files
+
+    Here are nested includes (``project file > foo.h > bar.h``) and ``LDF``
+    will find both libraries "Foo" and "Bar".
+
+:Case 2:
+
+    * ``lib_ldf_mode = 1``
+    * ``Foo/foo.cpp`` depends on "Bar" library (contains ``#include <bar.h>``)
+    * ``#include <foo.h>`` is located in one of the project source files
+
+    In this case, ``LDF`` will not find "Bar" library because it doesn't know
+    about CPP file (``Foo/foo.cpp``).
+
+:Case 3:
+
+    * ``lib_ldf_mode = 2``
+    * ``Foo/foo.cpp`` depends on "Bar" library (contains ``#include <bar.h>``)
+    * ``#include <foo.h>`` is located in one of the project source files
+
+    Firstly, ``LDF`` finds "Foo" library, then it parses all sources from "Foo"
+    library and finds ``Foo/foo.cpp`` that depends on ``#include <bar.h>``.
+    Secondly, it will parse all sources from "Bar" library and this operation
+    continues until all dependencies will not be parsed.
+
+.. _ldf_compat_mode:
+
+Compatibility Mode
+------------------
+
+Compatibility mode allows to control strictness of Library Dependency Finder.
+If library contains one of manifest file (:ref:`library_config`,
+``library.properties``, ``module.json``), then LDF check compatibility of this
+library with real build environment. Available compatibility modes:
+
+* ``0`` - does not check for compatibility (is not recommended)
+* ``1`` - **default** - checks for the compatibility with
+  :ref:`projectconf_env_framework` from build environment
+* ``2`` - checks for the compatibility with :ref:`projectconf_env_framework`
+  and :ref:`projectconf_env_platform` from build environment.
+
+This mode can be changed using :ref:`projectconf_lib_compat_mode` option in
+:ref:`projectconf`.
+
+.. _ldf_c_cond_syntax:
+
+C/C++ Preprocessor conditional syntax
+-------------------------------------
+
+In spite of the fact that Library Dependency Finder is written in pure Python,
+it interprets (emulates) `C/C++ Preprocessor conditional syntax <https://gcc.gnu.org/onlinedocs/cpp/Conditional-Syntax.html#Conditional-Syntax>`_
+(``#ifdef``, ``if``, ``defined``, ``else``, and ``elif``) without calling
+``gcc -E``. For example,
+
+``platformio.ini``
+
+.. code-block:: ini
+
+    [env:myenv]
+    build_flags = -D MY_PROJECT_VERSION=13
+
+``mylib.h``
+
+.. code-block:: c
+
+    #ifdef PROJECT_VERSION
+    // include common file for the project
+    #include "my_common.h"
+    #endif
+
+    #if PROJECT_VERSION < 10
+    // this include will be ignored because does not satisfy condition above
+    #include "my_old.h"
+    #endif

docs/migration.rst

@@ -0,0 +1,213 @@
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
+    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.
+
+.. _migration:
+
+Migrating from 2.x to 3.0
+=========================
+
+Guidance on how to upgrade from PlatformIO v2.x to v3.x with emphasis on major
+changes, what is new, and what is been removed.
+
+PlatformIO 3 is not backwards compatible with v2.x. Use this section as a
+general guide to upgrading from v2.x to v3.0. For a broader overview, see
+`what is new <https://community.platformio.org/c/announcements>`_ in the v3.0
+release announcement.
+
+.. contents::
+
+Major PlatformIO CLI changes
+----------------------------
+
+.. note::
+	PlatformIO 3.x is 100% non-blocking! You do not need to use ``--force``
+	option or setup special ``PLATOFMRIO_SETTING_ENABLE_PROMPTS`` environment.
+	Use PlatformIO 3.0 with sub-processing without any risk!
+
+This table shows the CLI changes between v2.x and v3.0.
+
+.. list-table::
+    :header-rows:  1
+
+    * - PlatformIO 2.x
+      - PlatformIO 3.x
+    * - platformio platforms
+      - :ref:`platformio platform <userguide_platform>`
+    * - platformio serialports
+      - :ref:`cmd_device`
+    * - platformio settings set enable_prompts false
+      - Removed! Now, all PlatformIO 3.0 CLI is 100% non-blocking!
+
+
+PlatformIO 2.x commands will be converted to PlatformIO 3.x automatically.
+Nevertheless, we recommend to use PlatformIO 3.x commands for the new projects.
+
+What is new
+-----------
+
+Development Platforms
+~~~~~~~~~~~~~~~~~~~~~
+
+We have introduced :ref:`platform_creating_manifest_file` and ported
+PlatformIO 2.x development platforms according PlatformIO 3.0 decentralized
+architecture. Now, platform related things (build scrips, LD scripts, board
+configs, package requirements) are located in own repository. Here is the full
+list with `PlatformIO 3.0 open source development platforms <https://github.com/platformio?utf8=✓&query=platform->`__. You can fork it, modify or create custom.
+See :ref:`platform_creating` guide for details.
+
+* :ref:`platform_creating_manifest_file`
+* ``espressif`` development platform has been renamed to :ref:`platform_espressif8266`
+* PlatformIO 3.0 :ref:`userguide_platform`
+* Custom package repositories
+* External embedded board configuration files, isolated build scripts
+* Embedded Board compatibility with more than one development platform
+
+Library Manager and Intelligent Build System
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* Powerful and super-fast :ref:`ldf` that interprets C/C++ Preprocessor
+  conditional macros with deep search behavior
+* Project dependencies per build environment using `projectconf_lib_deps` option
+* Depend on a library using VCS URL (GitHub, Git, ARM mbed code registry, Hg, SVN)
+* Install library by name
+* Strict search for library dependencies
+* Multiple library storages: Project's Local, PlatformIO's Global or Custom
+* Allowed :ref:`library_config` to specify sources other than PlatformIO's Repository
+* Check library compatibility with project environment before building
+* Control Library Dependency Finder for compatibility using :ref:`projectconf_lib_compat_mode` option
+* Custom library storages/directories with :ref:`projectconf_lib_extra_dirs` option
+* Handle extra build flags, source filters and build script from :ref:`library_config`
+* Allowed to disable library archiving (``*.ar``)
+* Show detailed build information about dependent libraries (Library Dependency Graph)
+* Support for the 3rd party manifests (Arduino IDE "library.properties" and
+  ARM mbed "module.json")
+* Build System: Attach custom Before/Pre and After/Post actions for targets using :ref:`projectconf_extra_script`
+
+Command Line Interface
+~~~~~~~~~~~~~~~~~~~~~~
+
+We have added new commands and changed some existing ones. Here are the new or
+updated commands and options.
+
+.. list-table::
+    :header-rows:  1
+
+    * - Command
+      - Description
+    * - :ref:`cmd_boards`
+      - Returns all supported boards by PlatformIO
+    * - :option:`platformio boards --installed`
+      - Returns currently installed boards
+    * - :option:`platformio ci --project-option`
+      - Pass custom option from :ref:`projectconf`
+    * - :option:`platformio ci --verbose`
+      - Print detailed information about build process
+    * - :option:`platformio init --project-option`
+      - Pass custom option from :ref:`projectconf`
+    * - :option:`platformio lib --global`
+      - Manage PlatformIO :ref:`Global Library Storage <ldf_storage>`
+    * - :option:`platformio lib --storage-dir`
+      - Manage :ref:`Custom Library Storage <ldf_storage>`
+    * - :ref:`cmd_lib_install`
+      - New PlatformIO 3.0 Library Manager! Semantic Versioning, VCS support and external URL support
+    * - :option:`platformio lib install --silent`
+      - Suppress progress reporting when install library
+    * - :option:`platformio lib install --interactive`
+      - Allow to make a choice for all prompts when install library
+    * - :option:`platformio lib search --header`
+      - Search library by specific header file name (include)
+    * - :option:`platformio lib update --only-check`
+      - Do not update, only check for new version
+    * - :ref:`platformio platform <userguide_platform>`
+      - New PlatformIO 3.0 Platform Manager! Semantic Versioning, VCS support and external URL support.
+    * - :option:`platformio platform update --only-packages`
+      - Update only platform packages
+    * - :option:`platformio platform update --only-check`
+      - Do not update, only check for new version
+    * - :ref:`cmd_run`
+      - By default, prints only human-readable information when processing environments
+    * - :option:`platformio run --verbose`
+      - Print detailed processing information
+    * - :ref:`platformio settings set force_verbose true <setting_force_verbose>`
+      - Force verbose output when processing environments (globally)
+    * - :ref:`cmd_test`
+      - PlatformIO Plus Unit Testing
+    * - :option:`platformio update --only-check`
+      - Do not update, only check for new version
+
+:ref:`projectconf`
+~~~~~~~~~~~~~~~~~~
+
+We have added new options and changed some existing ones. Here are the new or
+updated options.
+
+.. list-table::
+    :header-rows:  1
+
+    * - Section
+      - Option
+      - Description
+    * - platformio
+      - :ref:`projectconf_pio_libdeps_dir`
+      - Internal storage where :ref:`librarymanager` will install project dependencies
+    * - platformio
+      - :ref:`projectconf_pio_test_dir`
+      - Directory where :ref:`unit_testing` engine will look for the tests
+    * - env
+      - :ref:`projectconf_lib_deps`
+      - Specify project dependencies that should be installed automatically to :ref:`projectconf_pio_libdeps_dir` before environment processing.
+    * - env
+      - :ref:`projectconf_env_platform`
+      - PlatformIO 3.0 allows to use specific version of platform using `Semantic Versioning <http://semver.org>`_ (X.Y.Z=MAJOR.MINOR.PATCH).
+    * - env
+      - :ref:`projectconf_lib_extra_dirs`
+      - A list with extra directories/storages where :ref:`ldf` will look for dependencies
+    * - env
+      - :ref:`projectconf_lib_ldf_mode`
+      - This option specifies how does :ref:`ldf` should analyze dependencies (``#include`` directives)
+    * - env
+      - :ref:`projectconf_lib_compat_mode`
+      - Library compatibility mode allows to control strictness of :ref:`ldf`
+    * - env
+      - :ref:`projectconf_test_ignore`
+      - Ignore tests where the name matches specified patterns
+
+What is removed
+---------------
+
+Command Line Interface
+~~~~~~~~~~~~~~~~~~~~~~
+
+The following commands have been dropped or changed in v3.0.
+
+.. list-table::
+    :header-rows:  1
+
+    * - Command
+      - Description
+    * - platformio init --enable-auto-uploading
+      - Use :option:`platformio init --project-option` instead of it with ``targets = upload`` value
+
+:ref:`projectconf`
+~~~~~~~~~~~~~~~~~~
+
+The following options have been dropped or changed in v3.0.
+
+.. list-table::
+    :header-rows:  1
+
+    * - Section
+      - Option
+      - Description
+    * - platformio
+      - :ref:`projectconf_pio_lib_dir`
+      - Changed: Project's own/private libraries, where in PlatformIO 2.x it was global library storage
+

docs/platforms/atmelavr.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,24 +28,31 @@ Packages
     * - Name
       - Contents
 
-    * - ``toolchain-atmelavr``
-      - `avr-gcc <https://gcc.gnu.org/wiki/avr-gcc>`_, `GDB <http://www.gnu.org/software/gdb/>`_, `AVaRICE <http://avarice.sourceforge.net/>`_, `SimulAVR <http://www.nongnu.org/simulavr/>`_
+    * - ``framework-arduinoavr``
+      - `Arduino Wiring-based Framework (AVR Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
+
+    * - ``framework-simba``
+      - `Simba Framework <https://github.com/eerimoq/simba>`_
 
     * - ``tool-avrdude``
       - `AVRDUDE <http://www.nongnu.org/avrdude/>`_
 
-    * - ``framework-arduinoavr``
-      - `Arduino Wiring-based Framework (AVR Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
-
     * - ``tool-micronucleus``
       - `Micronucleus <https://github.com/micronucleus/micronucleus>`_
 
+    * - ``tool-scons``
+      - `SCons software construction tool <http://www.scons.org>`_
+
+    * - ``toolchain-atmelavr``
+      - `avr-gcc <https://gcc.gnu.org/wiki/avr-gcc>`_, `GDB <http://www.gnu.org/software/gdb/>`_, `AVaRICE <http://avarice.sourceforge.net/>`_, `SimulAVR <http://www.nongnu.org/simulavr/>`_
+
 .. 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).
 
-    **Windows Users:** Please check that you have correctly installed USB driver
-    from board manufacturer
+
+    **Windows Users:** Please check that you have correctly installed USB
+    driver from board manufacturer
 
 
 
@@ -58,14 +65,17 @@ Frameworks
       - 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.
+      - Arduino Wiring-based 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_simba`
+      - Simba is an RTOS and build framework. It aims to make embedded programming easy and portable.
 
 Boards
 ------
 
 .. note::
     * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
+      `PlatformIO Boards Explorer <http://platformio.org/boards>`_
     * For more detailed ``board`` information please scroll tables below by
       horizontal.
 
@@ -127,7 +137,7 @@ Adafruit
     * - ``protrinket3ftdi``
       - `Adafruit Pro Trinket 3V/12MHz (FTDI) <http://www.adafruit.com/products/2010>`_
       - ATMEGA328P
-      - 16 MHz
+      - 12 MHz
       - 32 Kb
       - 2 Kb
 
@@ -159,6 +169,33 @@ Adafruit
       - 8 Kb
       - 0.5 Kb
 
+Arduboy
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``arduboy``
+      - `Arduboy <https://www.arduboy.com>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``arduboy_devkit``
+      - `Arduboy DevKit <https://www.arduboy.com>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
 Arduino
 ~~~~~~~
 
@@ -207,6 +244,13 @@ Arduino
       - 32 Kb
       - 2 Kb
 
+    * - ``chiwawa``
+      - `Arduino Industrial 101 <http://www.arduino.org/products/boards/4-arduino-boards/arduino-industrial-101>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
     * - ``diecimilaatmega168``
       - `Arduino Duemilanove or Diecimila ATmega168 <http://arduino.cc/en/Main/ArduinoBoardDiecimila>`_
       - ATMEGA168
@@ -222,14 +266,14 @@ Arduino
       - 2 Kb
 
     * - ``esplora``
-      - `Arduino Esplora <http://arduino.cc/en/Main/ArduinoBoardEsplora>`_
+      - `Arduino Esplora <http://www.arduino.org/products/boards/4-arduino-boards/arduino-esplora>`_
       - ATMEGA32U4
       - 16 MHz
       - 32 Kb
       - 2.5 Kb
 
     * - ``ethernet``
-      - `Arduino Ethernet <http://arduino.cc/en/Main/ArduinoBoardEthernet>`_
+      - `Arduino Ethernet <http://www.arduino.org/products/boards/4-arduino-boards/arduino-ethernet>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
@@ -243,7 +287,14 @@ Arduino
       - 2 Kb
 
     * - ``leonardo``
-      - `Arduino Leonardo <http://arduino.cc/en/Main/arduinoBoardLeonardo>`_
+      - `Arduino Leonardo <http://www.arduino.org/products/boards/4-arduino-boards/arduino-leonardo>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``leonardoeth``
+      - `Arduino Leonardo ETH <http://www.arduino.org/products/boards/4-arduino-boards/arduino-leonardo-eth>`_
       - ATMEGA32U4
       - 16 MHz
       - 32 Kb
@@ -264,28 +315,28 @@ Arduino
       - 2 Kb
 
     * - ``megaADK``
-      - `Arduino Mega ADK <http://arduino.cc/en/Main/ArduinoBoardMegaADK>`_
+      - `Arduino Mega ADK <http://www.arduino.org/products/boards/4-arduino-boards/arduino-mega-adk>`_
       - ATMEGA2560
       - 16 MHz
       - 256 Kb
       - 8 Kb
 
     * - ``megaatmega1280``
-      - `Arduino Mega or Mega 2560 ATmega1280 <http://arduino.cc/en/Main/arduinoBoardMega>`_
+      - `Arduino Mega or Mega 2560 ATmega1280 <http://www.arduino.org/products/boards/4-arduino-boards/arduino-mega-2560>`_
       - ATMEGA1280
       - 16 MHz
       - 128 Kb
       - 8 Kb
 
     * - ``megaatmega2560``
-      - `Arduino Mega or Mega 2560 ATmega2560 (Mega 2560) <http://arduino.cc/en/Main/arduinoBoardMega2560>`_
+      - `Arduino Mega or Mega 2560 ATmega2560 (Mega 2560) <http://www.arduino.org/products/boards/4-arduino-boards/arduino-mega-2560>`_
       - ATMEGA2560
       - 16 MHz
       - 256 Kb
       - 8 Kb
 
     * - ``micro``
-      - `Arduino Micro <http://arduino.cc/en/Main/ArduinoBoardMicro>`_
+      - `Arduino Micro <http://www.arduino.org/products/boards/4-arduino-boards/arduino-micro>`_
       - ATMEGA32U4
       - 16 MHz
       - 32 Kb
@@ -306,14 +357,14 @@ Arduino
       - 2 Kb
 
     * - ``nanoatmega168``
-      - `Arduino Nano ATmega168 <http://arduino.cc/en/Main/ArduinoBoardNano>`_
+      - `Arduino Nano ATmega168 <http://www.arduino.org/products/boards/4-arduino-boards/arduino-nano>`_
       - ATMEGA168
       - 16 MHz
       - 16 Kb
       - 1 Kb
 
     * - ``nanoatmega328``
-      - `Arduino Nano ATmega328 <http://arduino.cc/en/Main/ArduinoBoardNano>`_
+      - `Arduino Nano ATmega328 <http://www.arduino.org/products/boards/4-arduino-boards/arduino-nano>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
@@ -348,28 +399,35 @@ Arduino
       - 2 Kb
 
     * - ``robotControl``
-      - `Arduino Robot Control <http://arduino.cc/en/Main/Robot>`_
+      - `Arduino Robot Control <http://www.arduino.org/products/boards/4-arduino-boards/arduino-robot>`_
       - ATMEGA32U4
       - 16 MHz
       - 32 Kb
       - 2.5 Kb
 
     * - ``robotMotor``
-      - `Arduino Robot Motor <http://arduino.cc/en/Main/Robot>`_
+      - `Arduino Robot Motor <http://www.arduino.org/products/boards/4-arduino-boards/arduino-robot>`_
       - ATMEGA32U4
       - 16 MHz
       - 32 Kb
       - 2.5 Kb
 
     * - ``uno``
-      - `Arduino Uno <http://arduino.cc/en/Main/ArduinoBoardUno>`_
+      - `Arduino Uno <http://www.arduino.org/products/boards/4-arduino-boards/arduino-uno>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
       - 2 Kb
 
     * - ``yun``
-      - `Arduino Yun <http://arduino.cc/en/Main/ArduinoBoardYun>`_
+      - `Arduino Yun <http://www.arduino.org/products/boards/4-arduino-boards/arduino-yun>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``yunmini``
+      - `Arduino Yun Mini <http://www.arduino.org/products/boards/4-arduino-boards/arduino-yun-mini>`_
       - ATMEGA32U4
       - 16 MHz
       - 32 Kb
@@ -490,6 +548,68 @@ Engduino
       - 32 Kb
       - 2.5 Kb
 
+Generic ATTiny
+~~~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``attiny13``
+      - `Generic ATTiny13 <http://www.atmel.com/devices/ATTINY13.aspx>`_
+      - ATTINY13
+      - 9 MHz
+      - 1 Kb
+      - 0.0625 Kb
+
+    * - ``attiny24``
+      - `Generic ATTiny24 <http://www.atmel.com/devices/ATTINY24.aspx>`_
+      - ATTINY24
+      - 8 MHz
+      - 2 Kb
+      - 0.125 Kb
+
+    * - ``attiny25``
+      - `Generic ATTiny25 <http://www.atmel.com/devices/ATTINY25.aspx>`_
+      - ATTINY25
+      - 8 MHz
+      - 2 Kb
+      - 0.125 Kb
+
+    * - ``attiny44``
+      - `Generic ATTiny44 <http://www.atmel.com/devices/ATTINY44.aspx>`_
+      - ATTINY44
+      - 8 MHz
+      - 4 Kb
+      - 0.25 Kb
+
+    * - ``attiny45``
+      - `Generic ATTiny45 <http://www.atmel.com/devices/ATTINY45.aspx>`_
+      - ATTINY45
+      - 8 MHz
+      - 4 Kb
+      - 0.25 Kb
+
+    * - ``attiny84``
+      - `Generic ATTiny84 <http://www.atmel.com/devices/ATTINY84.aspx>`_
+      - ATTINY84
+      - 8 MHz
+      - 8 Kb
+      - 0.5 Kb
+
+    * - ``attiny85``
+      - `Generic ATTiny85 <http://www.atmel.com/devices/ATTINY85.aspx>`_
+      - ATTINY85
+      - 8 MHz
+      - 8 Kb
+      - 0.5 Kb
+
 LightUp
 ~~~~~~~
 
@@ -510,6 +630,26 @@ LightUp
       - 32 Kb
       - 2.5 Kb
 
+Linino
+~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``one``
+      - `Linino One <http://www.linino.org/portfolio/linino-one/>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
 LowPowerLab
 ~~~~~~~~~~~
 
@@ -537,6 +677,68 @@ LowPowerLab
       - 128 Kb
       - 16 Kb
 
+Mcudude
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``mightycore1284``
+      - `MightyCore ATmega1284 <https://www.tindie.com/products/MCUdude/dip-40-arduino-compatible-development-board>`_
+      - ATMEGA1284P
+      - 16 MHz
+      - 128 Kb
+      - 16 Kb
+
+    * - ``mightycore16``
+      - `MightyCore ATmega16 <https://www.tindie.com/products/MCUdude/dip-40-arduino-compatible-development-board>`_
+      - ATMEGA16
+      - 16 MHz
+      - 16 Kb
+      - 1 Kb
+
+    * - ``mightycore164``
+      - `MightyCore ATmega164 <https://www.tindie.com/products/MCUdude/dip-40-arduino-compatible-development-board>`_
+      - ATMEGA164P
+      - 16 MHz
+      - 16 Kb
+      - 1 Kb
+
+    * - ``mightycore32``
+      - `MightyCore ATmega32 <https://www.tindie.com/products/MCUdude/dip-40-arduino-compatible-development-board>`_
+      - ATMEGA32
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``mightycore324``
+      - `MightyCore ATmega324 <https://www.tindie.com/products/MCUdude/dip-40-arduino-compatible-development-board>`_
+      - ATMEGA324P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``mightycore644``
+      - `MightyCore ATmega644 <https://www.tindie.com/products/MCUdude/dip-40-arduino-compatible-development-board>`_
+      - ATMEGA644P
+      - 16 MHz
+      - 64 Kb
+      - 4 Kb
+
+    * - ``mightycore8535``
+      - `MightyCore ATmega8535 <https://www.tindie.com/products/MCUdude/dip-40-arduino-compatible-development-board>`_
+      - ATMEGA16
+      - 16 MHz
+      - 8 Kb
+      - 0.5 Kb
+
 Microduino
 ~~~~~~~~~~
 
@@ -613,6 +815,26 @@ Microduino
       - 64 Kb
       - 4 Kb
 
+OpenEnergyMonitor
+~~~~~~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``emonpi``
+      - `OpenEnergyMonitor emonPi <https://github.com/openenergymonitor/emonpi>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
 PanStamp
 ~~~~~~~~
 
@@ -633,6 +855,26 @@ PanStamp
       - 32 Kb
       - 2 Kb
 
+Pinoccio
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``pinoccio``
+      - `Pinoccio Scout <https://www.crowdsupply.com/pinoccio/mesh-sensor-network>`_
+      - ATMEGA256RFR2
+      - 16 MHz
+      - 256 Kb
+      - 32 Kb
+
 Punch Through
 ~~~~~~~~~~~~~
 
@@ -740,20 +982,13 @@ Sanguino
       - Flash
       - RAM
 
-    * - ``sanguino_atmega12848m``
+    * - ``sanguino_atmega1284_8m``
       - `Sanguino ATmega1284p (8MHz) <https://code.google.com/p/sanguino/>`_
       - ATMEGA1284P
       - 8 MHz
       - 128 Kb
       - 16 Kb
 
-    * - ``sanguino_atmega1284m``
-      - `Sanguino ATmega1284p (20MHz) <https://code.google.com/p/sanguino/>`_
-      - ATMEGA1284P
-      - 20 MHz
-      - 128 Kb
-      - 16 Kb
-
     * - ``sanguino_atmega1284p``
       - `Sanguino ATmega1284p (16MHz) <https://code.google.com/p/sanguino/>`_
       - ATMEGA1284P
@@ -761,13 +996,34 @@ Sanguino
       - 128 Kb
       - 16 Kb
 
+    * - ``sanguino_atmega644``
+      - `Sanguino ATmega644 or ATmega644A (16 MHz) <https://code.google.com/p/sanguino/>`_
+      - ATMEGA644
+      - 16 MHz
+      - 64 Kb
+      - 4 Kb
+
+    * - ``sanguino_atmega644_8m``
+      - `Sanguino ATmega644 or ATmega644A (8 MHz) <https://code.google.com/p/sanguino/>`_
+      - ATMEGA644
+      - 8 MHz
+      - 64 Kb
+      - 4 Kb
+
     * - ``sanguino_atmega644p``
-      - `Sanguino ATmega644P <https://code.google.com/p/sanguino/>`_
+      - `Sanguino ATmega644P or ATmega644PA (16 MHz) <https://code.google.com/p/sanguino/>`_
       - ATMEGA644P
       - 16 MHz
       - 64 Kb
       - 4 Kb
 
+    * - ``sanguino_atmega644p_8m``
+      - `Sanguino ATmega644P or ATmega644PA (8 MHz) <https://code.google.com/p/sanguino/>`_
+      - ATMEGA644P
+      - 8 MHz
+      - 64 Kb
+      - 4 Kb
+
 SparkFun
 ~~~~~~~~
 

docs/platforms/atmelavr_extra.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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
@@ -30,7 +30,7 @@ Configuration for the programmers:
         upload_protocol = stk500v1
         upload_flags = -P$UPLOAD_PORT
 
-        # edit this line with valid upload port
+        ; edit this line with valid upload port
         upload_port = SERIAL_PORT_HERE
 
 *   AVRISP mkII
@@ -52,6 +52,15 @@ Configuration for the programmers:
         framework = arduino
         upload_protocol = usbtiny
 
+*   ArduinoISP
+
+    .. code-block:: ini
+
+        [env:myenv]
+        platform = atmelavr
+        framework = arduino
+        upload_protocol = arduinoisp
+
 *   USBasp
 
     .. code-block:: ini
@@ -82,10 +91,17 @@ Configuration for the programmers:
         upload_protocol = stk500v1
         upload_flags = -P$UPLOAD_PORT -b$UPLOAD_SPEED
 
-        # edit these lines
+        ; edit these lines
         upload_port = SERIAL_PORT_HERE
         upload_speed = 19200
 
+Upload EEPROM data
+------------------
+
+To upload EEPROM data (from EEMEM directive) you need to use ``uploadeep``
+target instead ``upload`` for :option:`platformio run --target` command.
+For example, ``platformio run -t uploadeep``.
+
 Articles
 --------
 
@@ -103,13 +119,13 @@ 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>`_.
+`Examples for Atmel AVR platform <https://github.com/platformio/platformio-examples/tree/develop/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>`_
+* `Wiring Blink <https://github.com/platformio/platformio-examples/tree/develop/wiring-blink>`_
+* `Arduino with external libraries <https://github.com/platformio/platformio-examples/tree/develop/atmelavr-and-arduino/arduino-external-libs>`_
+* `Arduino with internal libraries <https://github.com/platformio/platformio-examples/tree/develop/atmelavr-and-arduino/arduino-internal-libs>`_
+* `Project uses source file name for "src" directory (Arduino project structure) <https://github.com/platformio/platformio-examples/tree/develop/atmelavr-and-arduino/arduino-own-src_dir>`_
+* `Atmel AVR Native blink <https://github.com/platformio/platformio-examples/tree/develop/atmelavr-and-arduino/atmelavr-native-blink>`_
+* `Digitstump Mouse <https://github.com/platformio/platformio-examples/tree/develop/atmelavr-and-arduino/digitstump-mouse>`_
+* `Engduino magnetometer <https://github.com/platformio/platformio-examples/tree/develop/atmelavr-and-arduino/engduino-magnetometer>`_
+* `PanStamp blink <https://github.com/platformio/platformio-examples/tree/develop/atmelavr-and-arduino/panstamp-blink>`_

docs/platforms/atmelsam.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,24 +31,34 @@ Packages
     * - ``framework-arduinosam``
       - `Arduino Wiring-based Framework (SAM Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
 
-    * - ``ldscripts``
-      - `Linker Scripts <https://sourceware.org/binutils/docs/ld/Scripts.html>`_
+    * - ``framework-mbed``
+      - `mbed Framework <http://mbed.org>`_
+
+    * - ``framework-simba``
+      - `Simba Framework <https://github.com/eerimoq/simba>`_
+
+    * - ``tool-avrdude``
+      - `AVRDUDE <http://www.nongnu.org/avrdude/>`_
+
+    * - ``tool-bossac``
+      - `BOSSA CLI <https://sourceforge.net/projects/b-o-s-s-a/>`_
 
     * - ``tool-openocd``
       - `OpenOCD <http://openocd.org>`_
 
+    * - ``tool-scons``
+      - `SCons software construction tool <http://www.scons.org>`_
+
     * - ``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/>`_
-
 .. 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).
 
-    **Windows Users:** Please check that you have correctly installed USB driver
-    from board manufacturer
+
+    **Windows Users:** Please check that you have correctly installed USB
+    driver from board manufacturer
 
 
 
@@ -61,17 +71,43 @@ Frameworks
       - 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.
+      - Arduino Wiring-based 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_simba`
+      - Simba is an RTOS and build framework. It aims to make embedded programming easy and portable.
+
+    * - :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
 ------
 
 .. note::
     * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
+      `PlatformIO Boards Explorer <http://platformio.org/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
+
+    * - ``adafruit_feather_m0_usb``
+      - `Adafruit Feather M0 <https://www.adafruit.com/product/2772>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
 Arduino
 ~~~~~~~
 
@@ -86,19 +122,54 @@ Arduino
       - RAM
 
     * - ``due``
-      - `Arduino Due (Programming Port) <http://arduino.cc/en/Main/arduinoBoardDue>`_
+      - `Arduino Due (Programming Port) <http://www.arduino.org/products/boards/4-arduino-boards/arduino-due>`_
       - SAM3X8E
       - 84 MHz
       - 512 Kb
       - 32 Kb
 
     * - ``dueUSB``
-      - `Arduino Due (USB Native Port) <http://arduino.cc/en/Main/arduinoBoardDue>`_
+      - `Arduino Due (USB Native Port) <http://www.arduino.org/products/boards/4-arduino-boards/arduino-due>`_
       - SAM3X8E
       - 84 MHz
       - 512 Kb
       - 32 Kb
 
+    * - ``mkr1000USB``
+      - `Arduino MKR1000 <https://www.arduino.cc/en/Main/ArduinoMKR1000>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``mzeroUSB``
+      - `Arduino M0 <http://www.arduino.org/products/boards/arduino-m0>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``mzeropro``
+      - `Arduino M0 Pro (Programming Port) <http://www.arduino.org/products/boards/arduino-m0-pro>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``mzeroproUSB``
+      - `Arduino M0 Pro (Native USB Port) <http://www.arduino.org/products/boards/arduino-m0-pro>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``tian``
+      - `Arduino Tian <http://www.arduino.org/products/boards/arduino-tian>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
     * - ``zero``
       - `Arduino Zero (Programming Port) <https://www.arduino.cc/en/Main/ArduinoBoardZero>`_
       - SAMD21G18A
@@ -193,3 +264,30 @@ SainSmart
       - 84 MHz
       - 512 Kb
       - 32 Kb
+
+SparkFun
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``sparkfun_samd21_dev_usb``
+      - `SparkFun SAMD21 Dev Breakout <https://www.sparkfun.com/products/13672>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb
+
+    * - ``sparkfun_samd21_mini_usb``
+      - `SparkFun SAMD21 Mini Breakout <https://www.sparkfun.com/products/13664>`_
+      - SAMD21G18A
+      - 48 MHz
+      - 256 Kb
+      - 32 Kb

docs/platforms/creating_board.rst

@@ -1,4 +1,4 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
     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,13 +11,13 @@
 
 .. _board_creating:
 
-Custom Board
-============
+Custom Embedded Board
+=====================
 
 *PlatformIO* has pre-built settings for the most popular embedded boards. This
 list is available:
 
-* `Embedded Boards Explorer <http://platformio.org/#!/boards>`_ (Web)
+* `Embedded Boards Explorer <http://platformio.org/boards>`_ (Web)
 * :ref:`cmd_boards` (CLI command)
 
 Nevertheless, PlatformIO allows to create own board or override existing
@@ -33,32 +33,46 @@ JSON Structure
 
 The key fields:
 
-* ``build`` data will be used by :ref:`Platforms <platforms>` and
-  :ref:`frameworks` builders
+* ``build`` data will be used by :ref:`platforms` and :ref:`frameworks` builders
 * ``frameworks`` is the list with supported :ref:`frameworks`
-* ``platform`` main type of :ref:`Platforms <platforms>`
+* ``platform`` name of :ref:`platforms`
 * ``upload`` upload settings which depend on the ``platform``
 
 .. code-block:: json
 
     {
-        "myboard": {
-            "build": {},
-            "frameworks": ["%LIST_WITH_SUPPORTED_FRAMEWORKS%"],
-            "name": "My test board",
-            "platform": "%PLATFORM_TYPE_HERE%",
-            "upload": {},
-            "url": "http://example.com",
-            "vendor": "My Company Ltd."
-        }
+      "build": {
+        "extra_flags": "-DHELLO_PLATFORMIO",
+        "f_cpu": "16000000L",
+        "hwids": [
+          [
+            "0x1234",
+            "0x0013"
+          ],
+          [
+            "0x4567",
+            "0x0013"
+          ]
+        ],
+        "mcu": "%MCU_TYPE_HERE%"
+      },
+      "frameworks": ["%LIST_WITH_SUPPORTED_FRAMEWORKS%"],
+      "name": "My Test Board",
+      "upload": {
+        "maximum_ram_size": 2048,
+        "maximum_size": 32256
+      },
+      "url": "http://example.com",
+      "vendor": "MyCompany"
     }
 
+
 Installation
 ------------
 
 1. Create ``boards`` directory in :ref:`projectconf_pio_home_dir` if it
    doesn't exist.
-2. Create ``my_own_boards.json`` file and put to ``boards`` directory.
+2. Create ``myboard.json`` file and put to ``boards`` directory.
 3. Search available boards via :ref:`cmd_boards` command. You should see
    ``myboard`` board.
 
@@ -69,5 +83,6 @@ Now, you can use ``myboard`` for the :ref:`projectconf_env_board` option in
 Examples
 --------
 
-For the examples, please look into built-in ``*.json`` files with boards
-settings: https://github.com/platformio/platformio/tree/develop/platformio/boards.
+Please take a look at the source code of
+`PlatformIO Development Platforms <https://github.com/platformio?query=platform->`_
+and navigate to ``boards`` folder of the repository.