Merge branch 'release/v1.5.0'

Merge from "release"

.isort.cfg

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

HISTORY.rst

@@ -1,6 +1,75 @@
 Release History
 ===============
 
+1.5.0 (2015-05-15)
+------------------
+
+* 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>`__
+  with preconfigured IDE projects
+  (`issue #154 <https://github.com/platformio/platformio/issues/154>`_)
+* Fixed firmware uploading under Linux OS for Arduino Leonardo board
+  (`issue #178 <https://github.com/platformio/platformio/issues/178>`_)
+* Fixed invalid "mbed" firmware for Nucleo F411RE
+  (`issue #185 <https://github.com/platformio/platformio/issues/185>`_)
+* Fixed parsing of includes for PlatformIO Library Dependency Finder
+  (`issue #189 <https://github.com/platformio/platformio/issues/189>`_)
+* Fixed handling symbolic links within source code directory
+  (`issue #190 <https://github.com/platformio/platformio/issues/190>`_)
+* Fixed cancelling any previous definition of name, either built in or provided
+  with a ``-D`` option
+  (`issue #191 <https://github.com/platformio/platformio/issues/191>`_)
+
+1.4.0 (2015-04-11)
+------------------
+
+* Added `espressif <http://docs.platformio.org/en/latest/platforms/espressif.html>`_
+  development platform with ESP01 board
+* Integrated PlatformIO with AppVeyor Windows based Continuous Integration system
+  (`issue #149 <https://github.com/platformio/platformio/issues/149>`_)
+* Added support for Teensy LC board to
+  `teensy <http://docs.platformio.org/en/latest/platforms/teensy.html>`__
+  platform
+* Added support for new Arduino based boards by *SparkFun, BQ, LightUp,
+  LowPowerLab, Quirkbot, RedBearLab, TinyCircuits, WickedDevice* to
+  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
+  platform
+* Upgraded `Arduino Framework <http://docs.platformio.org/en/latest/frameworks/arduino.html>`__ to
+  1.6.3 version (`issue #156 <https://github.com/platformio/platformio/issues/156>`_)
+* Upgraded `Energia Framework <http://docs.platformio.org/en/latest/frameworks/energia.html>`__ to
+  0101E0015 version (`issue #146 <https://github.com/platformio/platformio/issues/146>`_)
+* Upgraded `Arduino Framework with Teensy Core <http://docs.platformio.org/en/latest/frameworks/arduino.html>`_ to
+  1.22 version (`issue #162 <https://github.com/platformio/platformio/issues/162>`_,
+  `issue #170 <https://github.com/platformio/platformio/issues/170>`_)
+* Fixed exceptions with PlatformIO auto-updates when Internet connection isn't
+  active
+
+
+1.3.0 (2015-03-27)
+------------------
+
+* Moved PlatformIO source code and repositories from `Ivan Kravets <https://github.com/ivankravets>`_
+  account to `PlatformIO Organisation <https://github.com/platformio>`_
+  (`issue #138 <https://github.com/platformio/platformio/issues/138>`_)
+* Added support for new Arduino based boards by *SparkFun, RepRap, Sanguino* to
+  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
+  platform
+  (`issue #127 <https://github.com/platformio/platformio/issues/127>`_,
+  `issue #131 <https://github.com/platformio/platformio/issues/131>`_)
+* Added integration instructions for `Visual Studio <http://docs.platformio.org/en/latest/ide/visualstudio.html>`_
+  and `Sublime Text <http://docs.platformio.org/en/latest/ide/sublimetext.html>`_ IDEs
+* Improved handling of multi-file ``*.ino/pde`` sketches
+  (`issue #130 <https://github.com/platformio/platformio/issues/130>`_)
+* Fixed wrong insertion of function prototypes converting ``*.ino/pde``
+  (`issue #137 <https://github.com/platformio/platformio/issues/137>`_,
+  `issue #140 <https://github.com/platformio/platformio/issues/140>`_)
+
+
+
 1.2.0 (2015-03-20)
 ------------------
 
@@ -20,10 +89,10 @@ Release History
   development platform
 * 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/ivankravets/platformio/issues/115>`_)
+  (`issue #115 <https://github.com/platformio/platformio/issues/115>`_)
 * Introduced online `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
 * Automatically append define ``-DPLATFORMIO=%version%`` to
-  builder (`issue #105 <https://github.com/ivankravets/platformio/issues/105>`_)
+  builder (`issue #105 <https://github.com/platformio/platformio/issues/105>`_)
 * Renamed ``stm32`` development platform to
   `ststm32 <http://docs.platformio.org/en/latest/platforms/ststm32.html>`__
 * Renamed ``opencm3`` framework to
@@ -31,13 +100,13 @@ Release History
 * Fixed uploading for `atmelsam <http://docs.platformio.org/en/latest/platforms/atmelsam.html>`__
   development platform
 * Fixed re-arranging the ``*.ino/pde`` files when converting to ``*.cpp``
-  (`issue #100 <https://github.com/ivankravets/platformio/issues/100>`_)
+  (`issue #100 <https://github.com/platformio/platformio/issues/100>`_)
 
 1.1.0 (2015-03-05)
 ------------------
 
 * Implemented ``PLATFORMIO_*`` environment variables
-  (`issue #102 <https://github.com/ivankravets/platformio/issues/102>`_)
+  (`issue #102 <https://github.com/platformio/platformio/issues/102>`_)
 * Added support for *SainSmart* boards to
   `atmelsam <http://docs.platformio.org/en/latest/platforms/atmelsam.html#boards>`__
   development platform
@@ -45,11 +114,11 @@ Release History
   `Project Configuration <http://docs.platformio.org/en/latest/projectconf.html>`__
   option named `envs_dir <http://docs.platformio.org/en/latest/projectconf.html#envs-dir>`__
 * Disabled "prompts" automatically for *Continuous Integration* systems
-  (`issue #103 <https://github.com/ivankravets/platformio/issues/103>`_)
+  (`issue #103 <https://github.com/platformio/platformio/issues/103>`_)
 * Fixed firmware uploading for
   `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
   boards which work within ``usbtiny`` protocol
-* Fixed uploading for *Digispark* board (`issue #106 <https://github.com/ivankravets/platformio/issues/106>`_)
+* Fixed uploading for *Digispark* board (`issue #106 <https://github.com/platformio/platformio/issues/106>`_)
 
 1.0.1 (2015-02-27)
 ------------------
@@ -62,14 +131,14 @@ Release History
   `BeagleBone <http://beagleboard.org>`_ and `CubieBoard <http://cubieboard.org>`_
 * Added `atmelsam <http://docs.platformio.org/en/latest/platforms/atmelsam.html>`__
   development platform with supported boards: *Arduino Due and Digistump DigiX*
-  (`issue #71 <https://github.com/ivankravets/platformio/issues/71>`_)
+  (`issue #71 <https://github.com/platformio/platformio/issues/71>`_)
 * Added `ststm32 <http://docs.platformio.org/en/latest/platforms/ststm32.html>`__
   development platform with supported boards: *Discovery kit for STM32L151/152,
   STM32F303xx, STM32F407/417 lines* and `libOpenCM3 Framework <http://www.libopencm3.org>`_
-  (`issue #73 <https://github.com/ivankravets/platformio/issues/73>`_)
+  (`issue #73 <https://github.com/platformio/platformio/issues/73>`_)
 * Added `teensy <http://docs.platformio.org/en/latest/platforms/teensy.html>`_
   development platform with supported boards: *Teensy 2.x & 3.x*
-  (`issue #72 <https://github.com/ivankravets/platformio/issues/72>`_)
+  (`issue #72 <https://github.com/platformio/platformio/issues/72>`_)
 * Added new *Arduino* boards to
   `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
   platform: *Arduino NG, Arduino BT, Arduino Esplora, Arduino Ethernet,
@@ -77,46 +146,46 @@ Release History
 * Added support for *Adafruit* boards to
   `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
   platform: *Adafruit Flora and Adafruit Trinkets*
-  (`issue #65 <https://github.com/ivankravets/platformio/issues/65>`_)
+  (`issue #65 <https://github.com/platformio/platformio/issues/65>`_)
 * Added support for *Digispark* boards to
   `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
   platform: *Digispark USB Development Board and Digispark Pro*
-  (`issue #47 <https://github.com/ivankravets/platformio/issues/47>`_)
-* Covered code with tests (`issue #2 <https://github.com/ivankravets/platformio/issues/2>`_)
+  (`issue #47 <https://github.com/platformio/platformio/issues/47>`_)
+* Covered code with tests (`issue #2 <https://github.com/platformio/platformio/issues/2>`_)
 * Refactored *Library Dependency Finder* (issues
-  `#48 <https://github.com/ivankravets/platformio/issues/48>`_,
-  `#50 <https://github.com/ivankravets/platformio/issues/50>`_,
-  `#55 <https://github.com/ivankravets/platformio/pull/55>`_)
+  `#48 <https://github.com/platformio/platformio/issues/48>`_,
+  `#50 <https://github.com/platformio/platformio/issues/50>`_,
+  `#55 <https://github.com/platformio/platformio/pull/55>`_)
 * Added `src_dir <http://docs.platformio.org/en/latest/projectconf.html#src-dir>`__
   option to ``[platformio]`` section of
   `platformio.ini <http://docs.platformio.org/en/latest/projectconf.html>`__
   which allows to redefine location to project's source directory
-  (`issue #83 <https://github.com/ivankravets/platformio/issues/83>`_)
+  (`issue #83 <https://github.com/platformio/platformio/issues/83>`_)
 * Added ``--json-output`` option to
   `platformio boards <http://docs.platformio.org/en/latest/userguide/cmd_boards.html>`__
   and `platformio search <http://docs.platformio.org/en/latest/userguide/cmd_search.html>`__
   commands which allows to return the output in `JSON <http://en.wikipedia.org/wiki/JSON>`_ format
-  (`issue #42 <https://github.com/ivankravets/platformio/issues/42>`_)
+  (`issue #42 <https://github.com/platformio/platformio/issues/42>`_)
 * Allowed to ignore some libs from *Library Dependency Finder* via
   `ignore_libs <http://docs.platformio.org/en/latest/projectconf.html#ignore-libs>`_ option
 * Improved `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
   command: asynchronous output for build process, timing and detailed
   information about environment configuration
-  (`issue #74 <https://github.com/ivankravets/platformio/issues/74>`_)
+  (`issue #74 <https://github.com/platformio/platformio/issues/74>`_)
 * Output compiled size and static memory usage with
   `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
-  command (`issue #59 <https://github.com/ivankravets/platformio/issues/59>`_)
+  command (`issue #59 <https://github.com/platformio/platformio/issues/59>`_)
 * Updated `framework-arduino` AVR & SAM to 1.6 stable version
 * Fixed an issue with the libraries that are git repositories
-  (`issue #49 <https://github.com/ivankravets/platformio/issues/49>`_)
+  (`issue #49 <https://github.com/platformio/platformio/issues/49>`_)
 * Fixed handling of assembly files
-  (`issue #58 <https://github.com/ivankravets/platformio/issues/58>`_)
+  (`issue #58 <https://github.com/platformio/platformio/issues/58>`_)
 * Fixed compiling error if space is in user's folder
-  (`issue #56 <https://github.com/ivankravets/platformio/issues/56>`_)
+  (`issue #56 <https://github.com/platformio/platformio/issues/56>`_)
 * Fixed `AttributeError: 'module' object has no attribute 'disable_warnings'`
   when a version of `requests` package is less then 2.4.0
 * Fixed bug with invalid process's "return code" when PlatformIO has internal
-  error (`issue #81 <https://github.com/ivankravets/platformio/issues/81>`_)
+  error (`issue #81 <https://github.com/platformio/platformio/issues/81>`_)
 * Several bug fixes, increased stability and performance improvements
 
 
@@ -124,10 +193,10 @@ Release History
 -------------------
 
 * Fixed an issue with ``--json-output``
-  (`issue #42 <https://github.com/ivankravets/platformio/issues/42>`_)
+  (`issue #42 <https://github.com/platformio/platformio/issues/42>`_)
 * Fixed an exception during
   `platformio upgrade <http://docs.platformio.org/en/latest/userguide/cmd_upgrade.html>`__
-  under Windows OS (`issue #45 <https://github.com/ivankravets/platformio/issues/45>`_)
+  under Windows OS (`issue #45 <https://github.com/platformio/platformio/issues/45>`_)
 
 0.10.1 (2015-01-02)
 -------------------
@@ -137,7 +206,7 @@ Release History
   `platformio serialports list <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html>`__ and
   `platformio lib list <http://docs.platformio.org/en/latest/userguide/lib/cmd_list.html>`__
   commands which allows to return the output in `JSON <http://en.wikipedia.org/wiki/JSON>`_ format
-  (`issue #42 <https://github.com/ivankravets/platformio/issues/42>`_)
+  (`issue #42 <https://github.com/platformio/platformio/issues/42>`_)
 * Fixed missing auto-uploading by default after `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`__
   command
 
@@ -147,31 +216,31 @@ Release History
 **Happy New Year!**
 
 * Implemented `platformio boards <http://docs.platformio.org/en/latest/userguide/cmd_boards.html>`_
-  command (`issue #11 <https://github.com/ivankravets/platformio/issues/11>`_)
+  command (`issue #11 <https://github.com/platformio/platformio/issues/11>`_)
 * Added support of *Engduino* boards for
   `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#engduino>`__
-  platform (`issue #38 <https://github.com/ivankravets/platformio/issues/38>`_)
+  platform (`issue #38 <https://github.com/platformio/platformio/issues/38>`_)
 * Added ``--board`` option to `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`__
   command which allows to initialise project with the specified embedded boards
-  (`issue #21 <https://github.com/ivankravets/platformio/issues/21>`_)
+  (`issue #21 <https://github.com/platformio/platformio/issues/21>`_)
 * Added `example with uploading firmware <http://docs.platformio.org/en/latest/projectconf.html#examples>`_
   via USB programmer (USBasp) for
   `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html>`_
-  *MCUs* (`issue #35 <https://github.com/ivankravets/platformio/issues/35>`_)
+  *MCUs* (`issue #35 <https://github.com/platformio/platformio/issues/35>`_)
 * Automatic detection of port on `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_
-  (`issue #37 <https://github.com/ivankravets/platformio/issues/37>`_)
-* Allowed auto-installation of platforms when prompts are disabled (`issue #43 <https://github.com/ivankravets/platformio/issues/43>`_)
-* Fixed urllib3's *SSL* warning under Python <= 2.7.2 (`issue #39 <https://github.com/ivankravets/platformio/issues/39>`_)
-* Fixed bug with *Arduino USB* boards (`issue #40 <https://github.com/ivankravets/platformio/issues/40>`_)
+  (`issue #37 <https://github.com/platformio/platformio/issues/37>`_)
+* Allowed auto-installation of platforms when prompts are disabled (`issue #43 <https://github.com/platformio/platformio/issues/43>`_)
+* Fixed urllib3's *SSL* warning under Python <= 2.7.2 (`issue #39 <https://github.com/platformio/platformio/issues/39>`_)
+* Fixed bug with *Arduino USB* boards (`issue #40 <https://github.com/platformio/platformio/issues/40>`_)
 
 0.9.2 (2014-12-10)
 ------------------
 
-* Replaced "dark blue" by "cyan" colour for the texts (`issue #33 <https://github.com/ivankravets/platformio/issues/33>`_)
+* 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)
-  (`issue #34 <https://github.com/ivankravets/platformio/issues/34>`_)
-* Fixed compilation bug on *Windows* with installed *MSVC* (`issue #18 <https://github.com/ivankravets/platformio/issues/18>`_)
+  (`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>`_)
 
 0.9.1 (2014-12-05)
 ------------------
@@ -183,9 +252,9 @@ Release History
 * Fixed "*OSError: [Errno 2] No such file or directory*" within
   `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
   command when PlatformIO isn't installed properly
-* Fixed example for `Eclipse IDE with Tiva board <https://github.com/ivankravets/platformio/tree/develop/examples/ide-eclipse>`_
-  (`issue #32 <https://github.com/ivankravets/platformio/pull/32>`_)
-* Upgraded `Eclipse Project Examples <https://github.com/ivankravets/platformio/tree/develop/examples/ide-eclipse>`_
+* Fixed example for `Eclipse IDE with Tiva board <https://github.com/platformio/platformio/tree/develop/examples/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>`_
   to latest *Luna* and *PlatformIO* releases
 
 0.9.0 (2014-12-01)
@@ -194,7 +263,7 @@ Release History
 * Implemented `platformio settings <http://docs.platformio.org/en/latest/userguide/cmd_settings.html>`_ command
 * Improved `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`_ command.
   Added new option ``--project-dir`` where you can specify another path to
-  directory where new project will be initialized (`issue #31 <https://github.com/ivankravets/platformio/issues/31>`_)
+  directory where new project will be initialized (`issue #31 <https://github.com/platformio/platformio/issues/31>`_)
 * Added *Migration Manager* which simplifies process with upgrading to a
   major release
 * Added *Telemetry Service* which should help us make *PlatformIO* better
@@ -202,9 +271,9 @@ Release History
   ``.platformio`` states.
 * Refactored *Package Manager*
 * Download Manager: fixed SHA1 verification within *Cygwin Environment*
-  (`issue #26 <https://github.com/ivankravets/platformio/issues/26>`_)
+  (`issue #26 <https://github.com/platformio/platformio/issues/26>`_)
 * Fixed bug with code builder and built-in Arduino libraries
-  (`issue #28 <https://github.com/ivankravets/platformio/issues/28>`_)
+  (`issue #28 <https://github.com/platformio/platformio/issues/28>`_)
 
 0.8.0 (2014-10-19)
 ------------------
@@ -213,7 +282,7 @@ Release History
   with the new fields: `frameworks <http://docs.platformio.org/en/latest/librarymanager/config.html#frameworks>`_,
   `platforms <http://docs.platformio.org/en/latest/librarymanager/config.html#platforms>`_
   and `dependencies <http://docs.platformio.org/en/latest/librarymanager/config.html#dependencies>`_
-  (`issue #17 <https://github.com/ivankravets/platformio/issues/17>`_)
+  (`issue #17 <https://github.com/platformio/platformio/issues/17>`_)
 * Switched logic from "Library Name" to "Library Registry ID" for all
   `platformio lib <http://docs.platformio.org/en/latest/userguide/lib/index.html>`_
   commands (install, uninstall, update and etc.)
@@ -227,8 +296,8 @@ Release History
 ------------------
 
 * Fixed bug with order for includes in conversation from INO/PDE to CPP
-* Automatic detection of port on upload (`issue #15 <https://github.com/ivankravets/platformio/issues/15>`_)
-* Fixed lib update crashing when no libs are installed (`issue #19 <https://github.com/ivankravets/platformio/issues/19>`_)
+* Automatic detection of port on upload (`issue #15 <https://github.com/platformio/platformio/issues/15>`_)
+* Fixed lib update crashing when no libs are installed (`issue #19 <https://github.com/platformio/platformio/issues/19>`_)
 
 
 0.7.0 (2014-09-24)
@@ -236,14 +305,14 @@ Release History
 
 * Implemented new `[platformio] <http://docs.platformio.org/en/latest/projectconf.html#platformio>`_
   section for Configuration File with `home_dir <http://docs.platformio.org/en/latest/projectconf.html#home-dir>`_
-  option (`issue #14 <https://github.com/ivankravets/platformio/issues/14>`_)
-* Implemented *Library Manager* (`issue #6 <https://github.com/ivankravets/platformio/issues/6>`_)
+  option (`issue #14 <https://github.com/platformio/platformio/issues/14>`_)
+* Implemented *Library Manager* (`issue #6 <https://github.com/platformio/platformio/issues/6>`_)
 
 0.6.0 (2014-08-09)
 ------------------
 
-* Implemented `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ (`issue #10 <https://github.com/ivankravets/platformio/issues/10>`_)
-* Fixed an issue ``ImportError: No module named platformio.util`` (`issue #9 <https://github.com/ivankravets/platformio/issues/9>`_)
+* Implemented `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ (`issue #10 <https://github.com/platformio/platformio/issues/10>`_)
+* Fixed an issue ``ImportError: No module named platformio.util`` (`issue #9 <https://github.com/platformio/platformio/issues/9>`_)
 * Fixed bug with auto-conversation from Arduino \*.ino to \*.cpp
 
 0.5.0 (2014-08-04)
@@ -252,12 +321,12 @@ Release History
 * Improved nested lookups for libraries
 * Disabled default warning flag "-Wall"
 * Added auto-conversation from \*.ino to valid \*.cpp for Arduino/Energia
-  frameworks (`issue #7 <https://github.com/ivankravets/platformio/issues/7>`_)
-* Added `Arduino example <https://github.com/ivankravets/platformio/tree/develop/examples/>`_
+  frameworks (`issue #7 <https://github.com/platformio/platformio/issues/7>`_)
+* Added `Arduino example <https://github.com/platformio/platformio/tree/develop/examples/>`_
   with external library (*Adafruit CC3000*)
 * Implemented `platformio upgrade <http://docs.platformio.org/en/latest/userguide/cmd_upgrade.html>`_
   command and "auto-check" for the latest
-  version (`issue #8 <https://github.com/ivankravets/platformio/issues/8>`_)
+  version (`issue #8 <https://github.com/platformio/platformio/issues/8>`_)
 * Fixed an issue with "auto-reset" for *Raspduino* board
 * Fixed a bug with nested libs building
 
@@ -292,17 +361,17 @@ Release History
 
 * Allowed to pass multiple "SomePlatform" to install/uninstall commands
 * Added "IDE Integration" section to README with Eclipse project examples
-* Created auto installer script for *PlatformIO* (`issue #3 <https://github.com/ivankravets/platformio/issues/3>`_)
+* Created auto installer script for *PlatformIO* (`issue #3 <https://github.com/platformio/platformio/issues/3>`_)
 * Added "Super-Quick" way to Installation section (README)
-* Implemented "build_flags" option for environments (`issue #4 <https://github.com/ivankravets/platformio/issues/4>`_)
+* Implemented "build_flags" option for environments (`issue #4 <https://github.com/platformio/platformio/issues/4>`_)
 
 
 0.2.0 (2014-06-15)
 ------------------
 
-* Resolved `issue #1 "Build referred libraries" <https://github.com/ivankravets/platformio/issues/1>`_
+* 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/ivankravets/platformio/tree/develop/examples/>`_ example
+* Added `arduino-internal-library <https://github.com/platformio/platformio/tree/develop/examples/>`_ example
 * Changed to beta status
 
 

README.rst

@@ -1,11 +1,14 @@
 PlatformIO
 ==========
 
-.. image:: https://travis-ci.org/ivankravets/platformio.svg?branch=develop
-    :target: https://travis-ci.org/ivankravets/platformio
-    :alt: Build Status
-.. image:: https://gemnasium.com/ivankravets/platformio.png
-    :target: https://gemnasium.com/ivankravets/platformio
+.. image:: https://travis-ci.org/platformio/platformio.svg?branch=develop
+    :target: https://travis-ci.org/platformio/platformio
+    :alt: Travis.CI Build Status
+.. image:: https://ci.appveyor.com/api/projects/status/ee26e58de798rctd/branch/develop?svg=true
+    :target: https://ci.appveyor.com/project/ivankravets/platformio
+    :alt: AppVeyor.CI Build Status
+.. image:: https://gemnasium.com/platformio/platformio.png
+    :target: https://gemnasium.com/platformio/platformio
     :alt: Dependency Status
 .. image:: https://pypip.in/version/platformio/badge.png?style=flat
     :target: https://pypi.python.org/pypi/platformio/
@@ -16,14 +19,21 @@ PlatformIO
 .. image:: https://pypip.in/license/platformio/badge.png?style=flat
     :target: https://pypi.python.org/pypi/platformio/
     :alt:  License
+.. image:: https://badges.gitter.im/Join%20Chat.svg
+   :alt: Join the chat at https://gitter.im/platformio/platformio
+   :target: https://gitter.im/platformio/platformio
 
 `Website + Library Search <http://platformio.org>`_ |
 `Documentation <http://docs.platformio.org>`_ |
-`Project Examples <https://github.com/ivankravets/platformio/tree/develop/examples>`_ |
+`Project Examples <https://github.com/platformio/platformio/tree/develop/examples>`_ |
 `Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
+`Reddit <http://www.reddit.com/r/platformio/>`_ |
 `Twitter <https://twitter.com/PlatformIO_Org>`_
 
-.. image:: https://raw.githubusercontent.com/ivankravets/platformio/develop/docs/_static/platformio-logo.png
+*Atmel AVR & SAM, Espressif, Freescale Kinetis, Nordic nRF51, NXP LPC,
+ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed, libOpenCM3, etc.*
+
+.. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-logo.png
     :target: http://platformio.org
 
 `PlatformIO <http://platformio.org>`_ is a cross-platform code builder
@@ -33,15 +43,18 @@ and the missing library manager.
 * `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
 * `Development Platforms <http://platformio.org/#!/platforms>`_
 * `Frameworks <http://platformio.org/#!/frameworks>`_
-* `Embedded Boards <http://platformio.org/#!/boards>`_
+* `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>`_
 * `IDE Integration <http://docs.platformio.org/en/latest/ide.html>`_
+* `Articles about us <http://docs.platformio.org/en/latest/articles.html>`_
+* `FAQ <http://docs.platformio.org/en/latest/faq.html>`_
 * `Release History <http://docs.platformio.org/en/latest/history.html>`_
 
 You have **no need** to install any *IDE* or compile any tool chains. *PlatformIO*
-has pre-built different development platforms including: compiler, debugger,
-uploader (for embedded boards) and many other useful tools.
+has pre-built different development platforms and pre-configured settings for
+the most popular embedded boards. For further details, please
+refer to `What is PlatformIO? <http://docs.platformio.org/en/latest/faq.html#what-is-platformio>`_
 
 Use whenever. *Run everywhere.*
 -------------------------------
@@ -57,7 +70,7 @@ 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>`_.
 
-* Colourful `command-line output <https://raw.githubusercontent.com/ivankravets/platformio/develop/examples/platformio-examples.png>`_
+* Colourful `command-line output <https://raw.githubusercontent.com/platformio/platformio/develop/examples/platformio-examples.png>`_
 * Built-in `Serial Port Monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_
 * Configurable `build -flags/-options <http://docs.platformio.org/en/latest/projectconf.html#build-flags>`_
 * Automatic **firmware uploading**
@@ -65,7 +78,7 @@ settings for most popular `Embedded Boards <http://platformio.org/#!/boards>`_.
 * Ready for **Cloud Compiling** and **Continuous Integration**
 * Pre-built tool chains, frameworks for the popular `Hardware Platforms <http://platformio.org/#!/platforms>`_
 
-.. image:: https://raw.githubusercontent.com/ivankravets/platformio-web/develop/app/images/platformio-embedded-development.png
+.. image:: https://raw.githubusercontent.com/platformio/platformio-web/develop/app/images/platformio-embedded-development.png
     :target: http://platformio.org
     :alt:  PlatformIO Embedded Development Process
 
@@ -76,13 +89,13 @@ platforms which allows you to organize and have up-to-date external libraries.
 
 * Friendly `Command-Line Interface <http://docs.platformio.org/en/latest/librarymanager/index.html>`_
 * Modern `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
-* Open Source `Library Registry API <https://github.com/ivankravets/platformio-api>`_
+* 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>`_
   specification
 * Library **dependency management**
 * Automatic library updating
 
-.. image:: https://raw.githubusercontent.com/ivankravets/platformio-web/develop/app/images/platformio-library-manager.png
+.. image:: https://raw.githubusercontent.com/platformio/platformio-web/develop/app/images/platformio-library-manager.png
     :target: http://platformio.org
     :alt:  PlatformIO Library Manager Architecture
 
@@ -98,7 +111,7 @@ cross-platform substitute for the classic *Make* utility.
 * Ability to share *built files in a cache*
 * Lookup for external libraries which are installed via `Library Manager <http://docs.platformio.org/en/latest/librarymanager/index.html>`_
 
-.. image:: https://raw.githubusercontent.com/ivankravets/platformio-web/develop/app/images/platformio-scons-builder.png
+.. image:: https://raw.githubusercontent.com/platformio/platformio-web/develop/app/images/platformio-scons-builder.png
     :target: http://platformio.org
     :alt:  PlatformIO Code Builder Architecture
 
@@ -117,6 +130,7 @@ 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>`_

appveyor.yml

@@ -0,0 +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"
+test_script:
+  - "%PYTHON_HOME%\\Scripts\\tox --version"
+  - "%PYTHON_HOME%\\Scripts\\pip --version"
+  - "%WITH_COMPILER% %PYTHON_HOME%\\Scripts\\tox"

docs/articles.rst

@@ -0,0 +1,17 @@
+.. _articles:
+
+Articles about us
+=================
+
+.. note::
+	If you've writeen 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:
+
+* 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/>`_
+* October 7, 2014 - **Ivan Kravets** - `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** - `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** - `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/faq.rst

@@ -0,0 +1,101 @@
+.. _faq:
+
+Frequently Asked Questions
+==========================
+
+.. contents::
+
+General
+-------
+
+.. _faq_what_is_platformio:
+
+What is PlatformIO?
+~~~~~~~~~~~~~~~~~~~
+
+`PlatformIO <http://platformio.org>`_ is a cross-platform code builder
+and the missing library manager.
+
+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_eclipse`,
+:ref:`ide_visualstudio`, :ref:`ide_vim`,  :ref:`ide_sublimetext`, etc.
+
+Alright, so PlatformIO can run on different operating systems. But more
+importantly, from development perspective at least, is a list of supported
+boards and MCUs. To keep things short: PlatformIO supports over 100
+:ref:`Embedded Boards <platforms>` 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.
+
+.. _faq_troubleshooting:
+
+Troubleshooting
+---------------
+
+.. _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 environment variable :ref:`PLATFORMIO_SETTING_ENABLE_PROMPTS=No <envvar_PLATFORMIO_SETTING_ENABLE_PROMPTS>`
+- disable global setting ``enable_prompts`` via :ref:`cmd_settings` command
+- masking under Continuous Integration system via environment variable
+  :ref:`CI=true <envvar_CI>`.
+
+
+Windows: ``UnicodeDecodeError: 'ascii' codec can't decode byte``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Answered in `issue #143 <https://github.com/platformio/platformio/issues/143#issuecomment-88060906>`_.
+
+Serial does not work with panStampAVR board
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Answered in `issue #144 <https://github.com/platformio/platformio/issues/144#issuecomment-87388038>`_.
+
+
+PlatformIO: command not found || An error ``pkg_resources.DistributionNotFound``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
+
+Please upgrade *SetupTools* package:
+
+.. code-block:: bash
+
+    $ [sudo] pip uninstall setuptools
+    $ [sudo] pip install setuptools
+
+    # Then re-install PlatformIO
+    $ [sudo] pip uninstall platformio
+    $ [sudo] pip install platformio

docs/frameworks/arduino.rst

@@ -22,6 +22,9 @@ Platforms
     * - :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_espressif`
+      - Espressif Systems is a privately held fabless semiconductor company. They provide wireless communications and Wi-Fi chips which are widely used in mobile devices and the Internet of Things applications.
+
     * - :ref:`platform_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.
 
@@ -57,28 +60,28 @@ Adafruit
       - 2.5 Kb
 
     * - ``protrinket3``
-      - `Pro Trinket 3V/12MHz (USB) <http://www.adafruit.com/products/2010>`_
+      - `Adafruit Pro Trinket 3V/12MHz (USB) <http://www.adafruit.com/products/2010>`_
       - ATMEGA328P
       - 12 MHz
       - 32 Kb
       - 2 Kb
 
     * - ``protrinket3ftdi``
-      - `Pro Trinket 3V/12MHz (FTDI) <http://www.adafruit.com/products/2010>`_
+      - `Adafruit Pro Trinket 3V/12MHz (FTDI) <http://www.adafruit.com/products/2010>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
       - 2 Kb
 
     * - ``protrinket5``
-      - `Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
+      - `Adafruit Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
       - 2 Kb
 
     * - ``protrinket5ftdi``
-      - `Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
+      - `Adafruit Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
@@ -112,7 +115,7 @@ Arduino
       - RAM
 
     * - ``LilyPadUSB``
-      - `LilyPad Arduino USB <http://arduino.cc/en/Main/ArduinoBoardLilyPadUSB>`_
+      - `Arduino LilyPad USB <http://arduino.cc/en/Main/ArduinoBoardLilyPadUSB>`_
       - ATMEGA32U4
       - 8 MHz
       - 32 Kb
@@ -203,14 +206,14 @@ Arduino
       - 2.5 Kb
 
     * - ``lilypadatmega168``
-      - `LilyPad Arduino ATmega168 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
+      - `Arduino LilyPad ATmega168 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
       - ATMEGA168
       - 8 MHz
       - 16 Kb
       - 1 Kb
 
     * - ``lilypadatmega328``
-      - `LilyPad Arduino ATmega328 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
+      - `Arduino LilyPad ATmega328 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
       - ATMEGA328P
       - 8 MHz
       - 32 Kb
@@ -328,6 +331,26 @@ Arduino
       - 32 Kb
       - 2.5 Kb
 
+BQ
+~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``zumbt328``
+      - `BQ ZUM BT-328 board <http://www.bq.com/gb/products/zum.html>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
 BitWizard
 ~~~~~~~~~
 
@@ -342,7 +365,7 @@ BitWizard
       - RAM
 
     * - ``raspduino``
-      - `Raspduino <http://www.bitwizard.nl/wiki/index.php/Raspduino>`_
+      - `BitWizard Raspduino <http://www.bitwizard.nl/wiki/index.php/Raspduino>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
@@ -362,28 +385,28 @@ Digistump
       - RAM
 
     * - ``digispark-pro``
-      - `Digispark Pro (Default 16 MHz) <http://digistump.com/products/109>`_
+      - `Digistump Digispark Pro (Default 16 MHz) <http://digistump.com/products/109>`_
       - ATTINY167
       - 16 MHz
       - 16 Kb
       - 0.5 Kb
 
     * - ``digispark-pro32``
-      - `Digispark Pro (16 MHz) (32 byte buffer) <http://digistump.com/products/109>`_
+      - `Digistump Digispark Pro (16 MHz) (32 byte buffer) <http://digistump.com/products/109>`_
       - ATTINY167
       - 16 MHz
       - 16 Kb
       - 0.5 Kb
 
     * - ``digispark-pro64``
-      - `Digispark Pro (16 MHz) (64 byte buffer) <http://digistump.com/products/109>`_
+      - `Digistump Digispark Pro (16 MHz) (64 byte buffer) <http://digistump.com/products/109>`_
       - ATTINY167
       - 16 MHz
       - 16 Kb
       - 0.5 Kb
 
     * - ``digispark-tiny``
-      - `Digispark (Default - 16 MHz) <http://digistump.com/products/1>`_
+      - `Digistump Digispark (Default - 16 MHz) <http://digistump.com/products/1>`_
       - ATTINY85
       - 16 MHz
       - 8 Kb
@@ -430,6 +453,73 @@ Engduino
       - 32 Kb
       - 2.5 Kb
 
+Espressif
+~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``esp01``
+      - `Espressif ESP8266 board <https://nurdspace.nl/ESP8266>`_
+      - ESP8266
+      - 80 MHz
+      - 512 Kb
+      - 32 Kb
+
+LightUp
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``lightup``
+      - `LightUp <https://www.lightup.io/>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+LowPowerLab
+~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``moteino``
+      - `LowPowerLab Moteino <https://lowpowerlab.com/shop/moteino-r4>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``moteinomega``
+      - `LowPowerLab MoteinoMEGA <http://lowpowerlab.com/blog/2014/08/09/moteinomega-available-now/>`_
+      - ATMEGA1284P
+      - 16 MHz
+      - 128 Kb
+      - 16 Kb
+
 Microduino
 ~~~~~~~~~~
 
@@ -533,6 +623,80 @@ PanStamp
       - 32 Kb
       - 4 Kb
 
+Quirkbot
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``quirkbot``
+      - `Quirkbot <http://quirkbot.com>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+RedBearLab
+~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``blend``
+      - `RedBearLab Blend <http://redbearlab.com/blend/>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``blendmicro16``
+      - `RedBearLab Blend Micro 3.3V/16MHz (overclock) <http://redbearlab.com/blendmicro/>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``blendmicro8``
+      - `RedBearLab Blend Micro 3.3V/8MHz <http://redbearlab.com/blendmicro/>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+RepRap
+~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``reprap_rambo``
+      - `RepRap RAMBo <http://reprap.org/wiki/Rambo>`_
+      - ATMEGA2560
+      - 16 MHz
+      - 256 Kb
+      - 8 Kb
+
 SainSmart
 ~~~~~~~~~
 
@@ -560,6 +724,130 @@ SainSmart
       - 512 Kb
       - 32 Kb
 
+Sanguino
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``sanguino_atmega12848m``
+      - `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
+      - 16 MHz
+      - 128 Kb
+      - 16 Kb
+
+    * - ``sanguino_atmega644p``
+      - `Sanguino ATmega644P <https://code.google.com/p/sanguino/>`_
+      - ATMEGA644P
+      - 16 MHz
+      - 64 Kb
+      - 4 Kb
+
+SparkFun
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``sparkfun_digitalsandbox``
+      - `SparkFun Digital Sandbox <https://www.sparkfun.com/products/12651>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``sparkfun_fiov3``
+      - `SparkFun Fio V3 3.3V/8MHz <https://www.sparkfun.com/products/11520>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``sparkfun_makeymakey``
+      - `SparkFun Makey Makey <https://www.sparkfun.com/products/11511>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``sparkfun_megamini``
+      - `SparkFun Mega Pro Mini 3.3V <https://www.sparkfun.com/products/10743>`_
+      - ATMEGA2560
+      - 8 MHz
+      - 256 Kb
+      - 8 Kb
+
+    * - ``sparkfun_megapro16MHz``
+      - `SparkFun Mega Pro 5V/16MHz <https://www.sparkfun.com/products/11007>`_
+      - ATMEGA2560
+      - 16 MHz
+      - 256 Kb
+      - 8 Kb
+
+    * - ``sparkfun_megapro8MHz``
+      - `SparkFun Mega Pro 3.3V/8MHz <https://www.sparkfun.com/products/10744>`_
+      - ATMEGA2560
+      - 8 MHz
+      - 256 Kb
+      - 8 Kb
+
+    * - ``sparkfun_promicro16``
+      - `SparkFun Pro Micro 5V/16MHz <https://www.sparkfun.com/products/12640>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``sparkfun_promicro8``
+      - `SparkFun Pro Micro 3.3V/8MHz <https://www.sparkfun.com/products/12587>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``sparkfun_redboard``
+      - `SparkFun RedBoard <https://www.sparkfun.com/products/12757>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``uview``
+      - `SparkFun MicroView <https://www.sparkfun.com/products/12923>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
 Teensy
 ~~~~~~
 
@@ -600,3 +888,64 @@ Teensy
       - 72 MHz
       - 256 Kb
       - 64 Kb
+
+    * - ``teensylc``
+      - `Teensy LC <http://www.pjrc.com/teensy/teensyLC.html>`_
+      - MKL26Z64
+      - 48 MHz
+      - 64 Kb
+      - 8 Kb
+
+TinyCircuits
+~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``tinyduino``
+      - `TinyCircuits TinyDuino Processor Board <https://tiny-circuits.com/tinyduino-processor-board.html>`_
+      - ATMEGA328P
+      - 8 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``tinylily``
+      - `TinyCircuits TinyLily Mini Processor <https://tiny-circuits.com/tiny-lily-mini-processor.html>`_
+      - ATMEGA328P
+      - 8 MHz
+      - 32 Kb
+      - 2 Kb
+
+WickedDevice
+~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``wildfirev2``
+      - `WickedDevice WildFire v2 [stk500] <http://shop.wickeddevice.com/resources/wildfire/#arduinoidesetup>`_
+      - ATMEGA1284P
+      - 16 MHz
+      - 128 Kb
+      - 16 Kb
+
+    * - ``wildfirev3``
+      - `WickedDevice WildFire v3 [optiboot] <http://shop.wickeddevice.com/resources/wildfire/>`_
+      - ATMEGA1284P
+      - 16 MHz
+      - 128 Kb
+      - 16 Kb

docs/frameworks/cmsis.rst

@@ -41,21 +41,21 @@ ST
       - RAM
 
     * - ``disco_f303vc``
-      - `STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
+      - `ST STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
       - STM32F303VCT6
       - 72 MHz
       - 256 Kb
       - 48 Kb
 
     * - ``disco_f407vg``
-      - `STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
+      - `ST STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
       - STM32F407VGT6
       - 168 MHz
       - 1024 Kb
       - 128 Kb
 
     * - ``disco_l152rb``
-      - `STM32LDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF258515>`_
+      - `ST STM32LDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF258515>`_
       - STM32L152RBT6
       - 32 MHz
       - 128 Kb

docs/frameworks/energia.rst

@@ -44,70 +44,70 @@ TI
       - RAM
 
     * - ``lplm4f120h5qr``
-      - `LaunchPad (Stellaris) w/ lm4f120 (80MHz) <http://www.ti.com/tool/ek-lm4f120xl>`_
+      - `TI LaunchPad (Stellaris) w/ lm4f120 (80MHz) <http://www.ti.com/tool/ek-lm4f120xl>`_
       - LPLM4F120H5QR
       - 80 MHz
       - 256 Kb
       - 32 Kb
 
     * - ``lpmsp430f5529``
-      - `LaunchPad w/ msp430f5529 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
+      - `TI LaunchPad w/ msp430f5529 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
       - MSP430F5529
       - 16 MHz
       - 128 Kb
       - 1 Kb
 
     * - ``lpmsp430f5529_25``
-      - `LaunchPad w/ msp430f5529 (25MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
+      - `TI LaunchPad w/ msp430f5529 (25MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
       - MSP430F5529
       - 25 MHz
       - 128 Kb
       - 1 Kb
 
     * - ``lpmsp430fr5739``
-      - `FraunchPad w/ msp430fr5739 <http://www.ti.com/tool/msp-exp430fr5739>`_
+      - `TI FraunchPad w/ msp430fr5739 <http://www.ti.com/tool/msp-exp430fr5739>`_
       - MSP430FR5739
       - 16 MHz
       - 16 Kb
       - 1 Kb
 
     * - ``lpmsp430fr5969``
-      - `LaunchPad w/ msp430fr5969 <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430fr5969.html>`_
+      - `TI LaunchPad w/ msp430fr5969 <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430fr5969.html>`_
       - MSP430FR5969
       - 8 MHz
       - 64 Kb
       - 1 Kb
 
     * - ``lpmsp430g2231``
-      - `LaunchPad w/ msp430g2231 (1 MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
+      - `TI LaunchPad w/ msp430g2231 (1 MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
       - MSP430G2231
       - 1 MHz
       - 2 Kb
       - 0.125 Kb
 
     * - ``lpmsp430g2452``
-      - `LaunchPad w/ msp430g2452 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
+      - `TI LaunchPad w/ msp430g2452 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
       - MSP430G2452
       - 16 MHz
       - 8 Kb
       - 0.25 Kb
 
     * - ``lpmsp430g2553``
-      - `LaunchPad w/ msp430g2553 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
+      - `TI LaunchPad w/ msp430g2553 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
       - MSP430G2553
       - 16 MHz
       - 16 Kb
       - 0.5 Kb
 
     * - ``lptm4c1230c3pm``
-      - `LaunchPad (Tiva C) w/ tm4c123 (80MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c123gxl.html>`_
+      - `TI LaunchPad (Tiva C) w/ tm4c123 (80MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c123gxl.html>`_
       - LPTM4C1230C3PM
       - 80 MHz
       - 256 Kb
       - 32 Kb
 
     * - ``lptm4c1294ncpdt``
-      - `LaunchPad (Tiva C) w/ tm4c129 (120MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c1294xl.html>`_
+      - `TI LaunchPad (Tiva C) w/ tm4c129 (120MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c1294xl.html>`_
       - LPTM4C1294NCPDT
       - 120 MHz
       - 1024 Kb

docs/frameworks/libopencm3.rst

@@ -44,21 +44,21 @@ ST
       - RAM
 
     * - ``disco_f303vc``
-      - `STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
+      - `ST STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
       - STM32F303VCT6
       - 72 MHz
       - 256 Kb
       - 48 Kb
 
     * - ``disco_f407vg``
-      - `STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
+      - `ST STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
       - STM32F407VGT6
       - 168 MHz
       - 1024 Kb
       - 128 Kb
 
     * - ``disco_l152rb``
-      - `STM32LDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF258515>`_
+      - `ST STM32LDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF258515>`_
       - STM32L152RBT6
       - 32 MHz
       - 128 Kb
@@ -78,21 +78,21 @@ TI
       - RAM
 
     * - ``lplm4f120h5qr``
-      - `LaunchPad (Stellaris) w/ lm4f120 (80MHz) <http://www.ti.com/tool/ek-lm4f120xl>`_
+      - `TI LaunchPad (Stellaris) w/ lm4f120 (80MHz) <http://www.ti.com/tool/ek-lm4f120xl>`_
       - LPLM4F120H5QR
       - 80 MHz
       - 256 Kb
       - 32 Kb
 
     * - ``lptm4c1230c3pm``
-      - `LaunchPad (Tiva C) w/ tm4c123 (80MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c123gxl.html>`_
+      - `TI LaunchPad (Tiva C) w/ tm4c123 (80MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c123gxl.html>`_
       - LPTM4C1230C3PM
       - 80 MHz
       - 256 Kb
       - 32 Kb
 
     * - ``lptm4c1294ncpdt``
-      - `LaunchPad (Tiva C) w/ tm4c129 (120MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c1294xl.html>`_
+      - `TI LaunchPad (Tiva C) w/ tm4c129 (120MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c1294xl.html>`_
       - LPTM4C1294NCPDT
       - 120 MHz
       - 1024 Kb

docs/frameworks/mbed.rst

@@ -50,7 +50,7 @@ CQ Publishing
       - RAM
 
     * - ``lpc11u35_501``
-      - `TG-LPC11U35-501 <https://developer.mbed.org/platforms/TG-LPC11U35-501/>`_
+      - `CQ Publishing TG-LPC11U35-501 <https://developer.mbed.org/platforms/TG-LPC11U35-501/>`_
       - LPC11U35
       - 48 MHz
       - 64 Kb
@@ -70,21 +70,21 @@ Embedded Artists
       - RAM
 
     * - ``lpc11u35``
-      - `EA LPC11U35 QuickStart Board <https://developer.mbed.org/platforms/EA-LPC11U35/>`_
+      - `Embedded Artists LPC11U35 QuickStart Board <https://developer.mbed.org/platforms/EA-LPC11U35/>`_
       - LPC11U35
       - 48 MHz
       - 64 Kb
       - 10 Kb
 
     * - ``lpc4088``
-      - `EA LPC4088 QuickStart Board <https://developer.mbed.org/platforms/EA-LPC4088/>`_
+      - `Embedded Artists LPC4088 QuickStart Board <https://developer.mbed.org/platforms/EA-LPC4088/>`_
       - LPC4088
       - 120 MHz
       - 512 Kb
       - 96 Kb
 
     * - ``lpc4088_dm``
-      - `EA LPC4088 Display Module <https://developer.mbed.org/platforms/EA-LPC4088-Display-Module/>`_
+      - `Embedded Artists LPC4088 Display Module <https://developer.mbed.org/platforms/EA-LPC4088-Display-Module/>`_
       - LPC4088
       - 120 MHz
       - 512 Kb
@@ -186,7 +186,7 @@ NGX Technologies
       - RAM
 
     * - ``blueboard_lpc11u24``
-      - `BlueBoard-LPC11U24 <https://developer.mbed.org/platforms/BlueBoard-LPC11U24/>`_
+      - `NGX Technologies BlueBoard-LPC11U24 <https://developer.mbed.org/platforms/BlueBoard-LPC11U24/>`_
       - LPC11U24
       - 48 MHz
       - 32 Kb
@@ -206,21 +206,21 @@ NXP
       - RAM
 
     * - ``lpc11u24``
-      - `mbed LPC11U24 <https://developer.mbed.org/platforms/mbed-LPC11U24/>`_
+      - `NXP mbed LPC11U24 <https://developer.mbed.org/platforms/mbed-LPC11U24/>`_
       - LPC11U24
       - 48 MHz
       - 32 Kb
       - 8 Kb
 
     * - ``lpc1549``
-      - `LPCXpresso1549 <https://developer.mbed.org/platforms/LPCXpresso1549/>`_
+      - `NXP LPCXpresso1549 <https://developer.mbed.org/platforms/LPCXpresso1549/>`_
       - LPC1549
       - 72 MHz
       - 256 Kb
       - 36 Kb
 
     * - ``lpc1768``
-      - `mbed LPC1768 <http://developer.mbed.org/platforms/mbed-LPC1768/>`_
+      - `NXP mbed LPC1768 <http://developer.mbed.org/platforms/mbed-LPC1768/>`_
       - LPC1768
       - 96 MHz
       - 512 Kb
@@ -321,49 +321,49 @@ ST
       - RAM
 
     * - ``disco_f051r8``
-      - `STM32F0DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF253215>`_
+      - `ST STM32F0DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF253215>`_
       - STM32F051R8T6
       - 48 MHz
       - 64 Kb
       - 8 Kb
 
     * - ``disco_f100rb``
-      - `STM32VLDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF250863>`_
+      - `ST STM32VLDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF250863>`_
       - STM32F100RBT6
       - 24 MHz
       - 128 Kb
       - 8 Kb
 
     * - ``disco_f303vc``
-      - `STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
+      - `ST STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
       - STM32F303VCT6
       - 72 MHz
       - 256 Kb
       - 48 Kb
 
     * - ``disco_f334c8``
-      - `32F3348DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF260318>`_
+      - `ST 32F3348DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF260318>`_
       - STM32F334C8T6
       - 72 MHz
       - 64 Kb
       - 16 Kb
 
     * - ``disco_f401vc``
-      - `32F401CDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF259098>`_
+      - `ST 32F401CDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF259098>`_
       - STM32F401VCT6
       - 84 MHz
       - 256 Kb
       - 64 Kb
 
     * - ``disco_f407vg``
-      - `STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
+      - `ST STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
       - STM32F407VGT6
       - 168 MHz
       - 1024 Kb
       - 128 Kb
 
     * - ``disco_f429zi``
-      - `32F429IDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF259090>`_
+      - `ST 32F429IDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF259090>`_
       - STM32F429ZIT6
       - 180 MHz
       - 2048 Kb
@@ -467,14 +467,14 @@ SeeedStudio
       - RAM
 
     * - ``seeedTinyBLE``
-      - `Seeed Tiny BLE <http://developer.mbed.org/platforms/Seeed-Tiny-BLE/>`_
+      - `SeeedStudio Seeed Tiny BLE <http://developer.mbed.org/platforms/Seeed-Tiny-BLE/>`_
       - NRF51822
       - 16 MHz
       - 256 Kb
       - 16 Kb
 
     * - ``seeeduinoArchPro``
-      - `Seeeduino-Arch-Pro <https://developer.mbed.org/platforms/Seeeduino-Arch-Pro/>`_
+      - `SeeedStudio Seeeduino-Arch-Pro <https://developer.mbed.org/platforms/Seeeduino-Arch-Pro/>`_
       - LPC1768
       - 96 MHz
       - 512 Kb
@@ -494,7 +494,7 @@ Solder Splash Labs
       - RAM
 
     * - ``dipcortexm0``
-      - `DipCortex M0 <https://developer.mbed.org/platforms/DipCortex-M0/>`_
+      - `Solder Splash Labs DipCortex M0 <https://developer.mbed.org/platforms/DipCortex-M0/>`_
       - LPC11U24
       - 50 MHz
       - 32 Kb
@@ -521,7 +521,7 @@ Switch Science
       - 16 Kb
 
     * - ``lpc1114fn28``
-      - `mbed LPC1114FN28 <https://developer.mbed.org/platforms/LPC1114FN28/>`_
+      - `Switch Science mbed LPC1114FN28 <https://developer.mbed.org/platforms/LPC1114FN28/>`_
       - LPC1114FN28
       - 48 MHz
       - 32 Kb

docs/frameworks/spl.rst

@@ -41,21 +41,21 @@ ST
       - RAM
 
     * - ``disco_f303vc``
-      - `STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
+      - `ST STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
       - STM32F303VCT6
       - 72 MHz
       - 256 Kb
       - 48 Kb
 
     * - ``disco_f407vg``
-      - `STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
+      - `ST STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
       - STM32F407VGT6
       - 168 MHz
       - 1024 Kb
       - 128 Kb
 
     * - ``disco_l152rb``
-      - `STM32LDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF258515>`_
+      - `ST STM32LDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF258515>`_
       - STM32L152RBT6
       - 32 MHz
       - 128 Kb

docs/ide.rst

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

docs/ide/arduino.rst

@@ -0,0 +1,31 @@
+.. _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.
+
+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>`_.
+
+
+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/eclipse.rst

@@ -0,0 +1,35 @@
+.. _ide_eclipse:
+
+Eclipse
+=======
+
+The `Eclipse CDT (C/C++ Development Tooling) <https://eclipse.org/cdt/>`_
+Project provides a fully functional C and C++ Integrated Development
+Environment based on the Eclipse platform. Features include: support for
+project creation and managed build for various toolchains, standard make
+build, source navigation, various source knowledge tools, such as type
+hierarchy, call graph, include browser, macro definition browser, code editor
+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 availalbe :ref:`platforms`
+* all availalbe :ref:`frameworks`
+
+Refer to the `CDT Documentation <https://eclipse.org/cdt/documentation.php>`_
+page for more detailed information.
+
+Integration
+-----------
+
+More detailed information is located in PlatformIO blog: `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_.
+
+`More examples (TI MSP430, TI TIVA, etc.) <https://github.com/platformio/platformio/tree/develop/examples/ide-eclipse>`_
+
+Screenshot
+----------
+
+.. image:: ../_static/ide-platformio-eclipse.png
+	:target: http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-    eclipse-ideplatformio

docs/ide/energia.rst

@@ -0,0 +1,30 @@
+.. _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.
+
+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>`_.
+
+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/qtcreator.rst

@@ -0,0 +1,113 @@
+.. _ide_qtcreator:
+
+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 availalbe :ref:`platforms`
+* all availalbe :ref:`frameworks`
+
+Refer to the `Sublime Text Documentation <http://doc.qt.io/qtcreator/>`_
+page for more detailed information.
+
+.. contents::
+
+Integration
+-----------
+
+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
+
+On the next steps select any available kit and click Finish button.
+
+.. image:: ../_static/ide-platformio-qtcreator-2.png
+
+Secondly, we need to configure project with PlatformIO source code builder (click on Projects label on left menu or ``Ctrl+5`` shortcut):
+
+.. image:: ../_static/ide-platformio-qtcreator-3.png
+
+Thirdly, we need to add directories with header files using project file. Please fill this file with the next contents:
+
+.. code-block:: none
+
+    win32 {
+        HOMEDIR += $$(USERPROFILE)
+    }
+    else {
+        HOMEDIR += $$(PWD)
+    }
+
+    INCLUDEPATH += "$$HOMEDIR/.platformio/packages/framework-arduinoavr/cores/arduino"
+    INCLUDEPATH += "$$HOMEDIR/.platformio/packages/toolchain-atmelavr/avr/include"
+
+    win32:INCLUDEPATH ~= s,/,\\,g
+
+.. image:: ../_static/ide-platformio-qtcreator-4.png
+
+First program in Qt Creator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+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 text file named ``main.c`` using ``Menu: New File or Project → General → Text File``:
+
+.. image:: ../_static/ide-platformio-qtcreator-5.png
+
+Copy the source code which is described below to file ``main.c``.
+
+.. code-block:: c
+
+    #include "Arduino.h"
+    #define WLED    13  // Most Arduino boards already have an LED attached to pin 13 on the board itself
+
+    void setup()
+    {
+      pinMode(WLED, OUTPUT);  // set pin as output
+    }
+
+    void loop()
+    {
+      digitalWrite(WLED, HIGH);  // set the LED on
+      delay(1000);               // wait for a second
+      digitalWrite(WLED, LOW);   // set the LED off
+      delay(1000);               // wait for a second
+    }
+
+2. Project Configuration File named ``platformio.ini`` must be located in the project root directory.
+
+.. image:: ../_static/ide-platformio-qtcreator-6.png
+
+Copy the source code which is described below to it.
+
+.. code-block:: none
+
+    #
+    # 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.
+
+    [env:arduino_uno]
+    platform = atmelavr
+    framework = arduino
+    board = uno
+
+
+Conclusion
+----------
+
+Taking everything into account, we can build project with shortcut ``Ctrl+Shift+B`` or using ``Menu: Build → Build All``:
+
+.. image:: ../_static/ide-platformio-qtcreator-7.png

docs/ide/sublimetext.rst

@@ -0,0 +1,129 @@
+.. _ide_sublimetext:
+
+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 availalbe :ref:`platforms`
+* all availalbe :ref:`frameworks`
+
+Refer to the `Sublime Text Documentation <http://docs.sublimetext.info/en/latest>`_
+page for more detailed information.
+
+.. contents::
+
+Integration
+-----------
+
+Initial configuration
+^^^^^^^^^^^^^^^^^^^^^
+
+First of all, we need to create "New Build System" with name "PlatformIO"
+from ``Menu: Tools → Build System → New Build System`` and fill it like
+described below:
+
+.. code-block:: bash
+
+    {
+        "cmd": ["platformio", "run"],
+        "working_dir": "${project_path:${folder}}",
+        "variants":
+        [
+            {
+                "name": "Clean",
+                "cmd": ["platformio", "run", "-t", "clean"]
+            },
+            {
+                "name": "Upload",
+                "cmd": ["platformio", "run", "-t", "upload"]
+            }
+        ]
+    }
+
+Secondly, we need to select "PlatformIO" Build System from a list:
+
+.. image:: ../_static/ide-sublime-text-platformio-newproject-2.png
+
+After that, we can use the necessary commands from
+``Menu: Tools → Command Palette`` or with ``Ctrl+Shift+P`` (Windows/Linux)
+``Cmd+Shift+P`` (Mac) shortcut.
+
+.. image:: ../_static/ide-sublime-text-platformio-newproject-3.png
+
+Command Hotkeys
+~~~~~~~~~~~~~~~
+
+Sublime Text allows to bind own hotkey per command. Let's setup them
+for PlatformIO commands using shortcut ``Menu: Preferences → Key-Bindings - User``:
+
+.. image:: ../_static/ide-sublime-text-platformio-newproject-4.png
+
+We are going to use these shortcuts:
+
+* ``F11`` for clean project
+* ``F12`` for upload firmware to target device
+
+In this case, the final code will look like:
+
+.. code-block:: none
+
+    [
+        { "keys": ["f11"], "command": "build", "args": {"variant": "Clean"} },
+        { "keys": ["f12"], "command": "build", "args": {"variant": "Upload"} }
+    ]
+
+First program in Sublime Text
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+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`` (Windows/Linux) ``Cmd+N`` (Mac) with the next contents:
+
+.. code-block:: c
+
+    #include "Arduino.h"
+    #define WLED    13  // Most Arduino boards already have an LED attached to pin 13 on the board itself
+
+    void setup()
+    {
+      pinMode(WLED, OUTPUT);  // set pin as output
+    }
+
+    void loop()
+    {
+      digitalWrite(WLED, HIGH);  // set the LED on
+      delay(1000);               // wait for a second
+      digitalWrite(WLED, LOW);   // set the LED off
+      delay(1000);               // wait for a second
+    }
+
+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
+
+    #
+    # 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.
+
+    [env:arduino_uno]
+    platform = atmelavr
+    framework = arduino
+    board = uno
+
+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``.
+
+.. image:: ../_static/ide-sublime-text-platformio-newproject-5.png

docs/ide/vim.rst

@@ -0,0 +1,46 @@
+.. _ide_vim:
+
+VIM
+===
+
+`VIM <http://www.vim.org/>`_ is an open-source, powerful and configurable text
+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 availalbe :ref:`platforms`
+* all availalbe :ref:`frameworks`
+
+Integration
+-----------
+
+Recommended bundles:
+
+* Syntax highlight - `Arduino-syntax-file <https://github.com/vim-scripts/Arduino-syntax-file>`_
+* Code Completion - `YouCompleteMe <https://github.com/Valloric/YouCompleteMe>`_ (see configuration example by **Anthony Ford** `PlatformIO/YouCompleteMe Integration <https://gist.github.com/ajford/f551b2b6fd4d6b6e1ef2>`_)
+* Syntax checking - `Syntastic <https://github.com/scrooloose/syntastic>`_
+
+Put to the project directory ``Makefile`` wrapper with contents:
+
+.. code-block:: make
+
+    # Uncomment lines below if you have problems with $PATH
+    #SHELL := /bin/bash
+    #PATH := /usr/local/bin:$(PATH)
+
+    all:
+        platformio run -t upload
+
+    clean:
+        platformio run -t clean
+
+
+Now, in VIM ``cd /path/to/this/project`` and press ``Ctrl+B`` or ``Cmd+B``
+(Mac). *PlatformIO* should compile your source code from the ``src`` directory,
+make firmware and upload it.
+
+Screenshot
+----------
+
+.. image:: ../_static/ide-platformio-vim.png

docs/ide/visualstudio.rst

@@ -0,0 +1,108 @@
+.. _ide_visualstudio:
+
+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 availalbe :ref:`platforms`
+* all availalbe :ref:`frameworks`
+
+Refer to the `Visual Studio Documentation <https://msdn.microsoft.com/library/vstudio>`_
+page for more detailed information.
+
+.. contents::
+
+Integration
+-----------
+
+Setup New Project
+^^^^^^^^^^^^^^^^^
+
+First of all, let's create new project from Visual Studio Start Page: ``Start → New Project`` or using ``Menu: File → New → Project``, then select project with ``Makefile`` type (``Visual C++ → General → Makefile Project``), fill ``Project name``, ``Solution name``, ``Location`` fields and press OK button.
+
+.. image:: ../_static/ide-vs-platformio-newproject.png
+
+Secondly, we need to configure project with PlatformIO source code builder:
+
+.. image:: ../_static/ide-vs-platformio-newproject-2.png
+
+If we want to use native AVR programming, we have to specify additional preprocessor symbol ("Preprocessor definitions" field) about your MCU. For example, an Arduino Uno is based on the ATmega328 MCU. In this case We will add new definition  ``__AVR_ATmega328__``.
+
+.. image:: ../_static/ide-vs-platformio-newproject-2-1.png
+
+Release Configuration is the same as Debug, so on the next step we check "Same as Debug Configuration" and click "Finish" button.
+
+.. image:: ../_static/ide-vs-platformio-newproject-3.png
+
+Thirdly, we need to add directories with header files using project properties (right click on the project name or ``Alt-Enter`` shortcut) and add two directories to ``Configuration Properties → NMake → Include Search Path``:
+
+.. code-block:: none
+
+    $(HOMEDRIVE)$(HOMEPATH)\.platformio\packages\toolchain-atmelavr\avr\include
+    $(HOMEDRIVE)$(HOMEPATH)\.platformio\packages\framework-arduinoavr\cores\arduino
+
+.. image:: ../_static/ide-vs-platformio-newproject-5.png
+
+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``:
+
+.. image:: ../_static/ide-vs-platformio-newproject-6.png
+
+Copy the source code which is described below to file ``main.c``.
+
+.. code-block:: c
+
+    #include "Arduino.h"
+    #define WLED    13  // Most Arduino boards already have an LED attached to pin 13 on the board itself
+
+    void setup()
+    {
+      pinMode(WLED, OUTPUT);  // set pin as output
+    }
+
+    void loop()
+    {
+      digitalWrite(WLED, HIGH);  // set the LED on
+      delay(1000);               // wait for a second
+      digitalWrite(WLED, LOW);   // set the LED off
+      delay(1000);               // wait for a second
+    }
+
+2. Project Configuration File named ``platformio.ini`` must be located in the project root directory.
+
+.. image:: ../_static/ide-vs-platformio-newproject-7.png
+
+Copy the source code which is described below to it.
+
+.. code-block:: none
+
+    #
+    # 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.
+
+    [env:arduino_uno]
+    platform = atmelavr
+    framework = arduino
+    board = uno
+
+
+Conclusion
+----------
+
+Taking everything into account, we can build project with shortcut ``Ctrl+Shift+B`` or using ``Menu: Build → Build Solution``:
+
+.. image:: ../_static/ide-vs-platformio-newproject-8.png

docs/index.rst

@@ -1,25 +1,26 @@
 PlatformIO: A cross-platform code builder and the missing library manager
 =========================================================================
 
+*Atmel AVR & SAM, Freescale Kinetis, Nordic nRF51, NXP LPC, ST STM32,
+TI MSP430 & Tiva, Teensy, Arduino, mbed, libOpenCM3, etc.*
+
 .. image:: _static/platformio-logo.png
     :target: http://platformio.org
 
-`Website + Library Search <http://platformio.org>`_ |
-`Project Examples <https://github.com/ivankravets/platformio/tree/develop/examples>`_ |
-`Source Code <https://github.com/ivankravets/platformio>`_ |
-`Issues <https://github.com/ivankravets/platformio/issues>`_ |
-`Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
-`Twitter <https://twitter.com/PlatformIO_Org>`_
+* `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>`_
+* `Source Code <https://github.com/platformio/platformio>`_ |
+  `Issues <https://github.com/platformio/platformio/issues>`_
+* `Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
+  `Reddit <http://www.reddit.com/r/platformio/>`_ |
+  `Twitter <https://twitter.com/PlatformIO_Org>`_
 
-You have no need to install any *IDE* or compile any tool chains. *PlatformIO*
-has pre-built different development platforms including: compiler, debugger,
-uploader (for embedded) and many other useful tools.
-
-**PlatformIO** allows developer to compile the same code with different
-platforms using only one command :ref:`cmd_run`. This happens due to
-:ref:`projectconf` where you can setup different environments with specific
-options: platform type, firmware uploading settings, pre-built framework
-and many more.
+You have **no need** to install any *IDE* or compile any tool chains. *PlatformIO*
+has pre-built different development platforms and pre-configured settings for
+the most popular embedded boards. For further details, please
+refer to :ref:`faq_what_is_platformio`
 
 Embedded Development. *Easier Than Ever.*
 -----------------------------------------
@@ -63,4 +64,6 @@ Contents
     librarymanager/index
     userguide/index
     ide
+    articles
+    FAQ <faq>
     history

docs/installation.rst

@@ -30,33 +30,37 @@ application:
   application.
 
 .. warning::
-    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:
+    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.
 
-    - using environment variable :ref:`PLATFORMIO_SETTING_ENABLE_PROMPTS=No <envvar_PLATFORMIO_SETTING_ENABLE_PROMPTS>`
-    - disable global setting ``enable_prompts`` via :ref:`cmd_settings` command
-    - masking under Continuous Integration system via environment variable
-      :ref:`CI=true <envvar_CI>`.
 
-Please *choose one of* the following:
+Troubleshooting
+---------------
+
+For further details, frequently questions, please refer to :ref:`faq`.
+
+Installation Methods
+--------------------
+
+Please *choose one of* the following installation methods:
 
 Super-Quick (Mac / Linux)
--------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 To install or upgrade *PlatformIO* paste that at a *Terminal* prompt
 (**you might need** to run ``sudo`` first):
 
 .. code-block:: bash
 
-    python -c "$(curl -fsSL https://raw.githubusercontent.com/ivankravets/platformio/master/scripts/get-platformio.py)"
+    python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
 
 
 Installer Script (Mac / Linux / Windows)
-----------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 To install or upgrade *PlatformIO*, download
-`get-platformio.py <https://raw.githubusercontent.com/ivankravets/platformio/develop/scripts/get-platformio.py>`_
+`get-platformio.py <https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py>`_
 script. Then run the following (you might need to run ``sudo`` first):
 
 .. code-block:: bash
@@ -70,16 +74,8 @@ On *Windows OS* it may look like:
 
     C:\Python27\python.exe get-platformio.py
 
-.. warning::
-    If you have an error ``pkg_resources.DistributionNotFound`` please
-    upgrade *SetupTools* package: ``$ [sudo] pip uninstall setuptools``
-    and ``$ [sudo] pip install setuptools``.
-    Then re-install *PlatformIO*: ``$ [sudo] pip uninstall platformio``
-    and ``$ [sudo] pip install platformio``.
-
-
 Full Guide
-----------
+~~~~~~~~~~
 
 1. Check a ``python`` version (only 2.6-2.7 is supported):
 
@@ -121,7 +117,7 @@ For upgrading the ``platformio`` to new version please use this command:
 
 
 Development Version
--------------------
+~~~~~~~~~~~~~~~~~~~
 
 .. warning::
     We don't recommend to use ``develop`` version in production.
@@ -136,8 +132,8 @@ Development Version
 
 .. code-block:: bash
 
-    $ pip install https://github.com/ivankravets/platformio/archive/develop.zip
+    $ pip install https://github.com/platformio/platformio/archive/develop.zip
 
 If you want to be up-to-date with the latest ``develop`` version of PlatformIO,
 then you need to perform step #2 each time if you see the new commits in
-`PlatformIO GitHub repository <https://github.com/ivankravets/platformio/commits/develop>`_.
+`PlatformIO GitHub repository <https://github.com/platformio/platformio/commits/develop>`_.

docs/librarymanager/config.rst

@@ -167,6 +167,16 @@ A version of the current library source code.
     |PIOAPICR| will use the *CVS*-revision from the latest commit.
 
 
+.. _libjson_url:
+
+``url``
+-------
+
+*Optional* | Type: ``String`` | Max. Length: 255
+
+Home page of library (if is different from :ref:`libjson_repository` url).
+
+
 .. _libjson_include:
 
 ``include``

docs/librarymanager/creating.rst

@@ -15,7 +15,7 @@ Source Code Location
 --------------------
 
 There are a several ways how to share your library with the whole world
-(see `examples <https://github.com/ivankravets/platformio-libmirror/tree/master/configs>`_).
+(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`

docs/platforms/atmelavr.rst

@@ -31,7 +31,7 @@ Packages
 
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/ivankravets/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
+    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
 
 
 
@@ -76,28 +76,28 @@ Adafruit
       - 2.5 Kb
 
     * - ``protrinket3``
-      - `Pro Trinket 3V/12MHz (USB) <http://www.adafruit.com/products/2010>`_
+      - `Adafruit Pro Trinket 3V/12MHz (USB) <http://www.adafruit.com/products/2010>`_
       - ATMEGA328P
       - 12 MHz
       - 32 Kb
       - 2 Kb
 
     * - ``protrinket3ftdi``
-      - `Pro Trinket 3V/12MHz (FTDI) <http://www.adafruit.com/products/2010>`_
+      - `Adafruit Pro Trinket 3V/12MHz (FTDI) <http://www.adafruit.com/products/2010>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
       - 2 Kb
 
     * - ``protrinket5``
-      - `Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
+      - `Adafruit Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
       - 2 Kb
 
     * - ``protrinket5ftdi``
-      - `Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
+      - `Adafruit Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
@@ -131,7 +131,7 @@ Arduino
       - RAM
 
     * - ``LilyPadUSB``
-      - `LilyPad Arduino USB <http://arduino.cc/en/Main/ArduinoBoardLilyPadUSB>`_
+      - `Arduino LilyPad USB <http://arduino.cc/en/Main/ArduinoBoardLilyPadUSB>`_
       - ATMEGA32U4
       - 8 MHz
       - 32 Kb
@@ -208,14 +208,14 @@ Arduino
       - 2.5 Kb
 
     * - ``lilypadatmega168``
-      - `LilyPad Arduino ATmega168 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
+      - `Arduino LilyPad ATmega168 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
       - ATMEGA168
       - 8 MHz
       - 16 Kb
       - 1 Kb
 
     * - ``lilypadatmega328``
-      - `LilyPad Arduino ATmega328 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
+      - `Arduino LilyPad ATmega328 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
       - ATMEGA328P
       - 8 MHz
       - 32 Kb
@@ -333,6 +333,26 @@ Arduino
       - 32 Kb
       - 2.5 Kb
 
+BQ
+~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``zumbt328``
+      - `BQ ZUM BT-328 board <http://www.bq.com/gb/products/zum.html>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
 BitWizard
 ~~~~~~~~~
 
@@ -347,7 +367,7 @@ BitWizard
       - RAM
 
     * - ``raspduino``
-      - `Raspduino <http://www.bitwizard.nl/wiki/index.php/Raspduino>`_
+      - `BitWizard Raspduino <http://www.bitwizard.nl/wiki/index.php/Raspduino>`_
       - ATMEGA328P
       - 16 MHz
       - 32 Kb
@@ -367,28 +387,28 @@ Digistump
       - RAM
 
     * - ``digispark-pro``
-      - `Digispark Pro (Default 16 MHz) <http://digistump.com/products/109>`_
+      - `Digistump Digispark Pro (Default 16 MHz) <http://digistump.com/products/109>`_
       - ATTINY167
       - 16 MHz
       - 16 Kb
       - 0.5 Kb
 
     * - ``digispark-pro32``
-      - `Digispark Pro (16 MHz) (32 byte buffer) <http://digistump.com/products/109>`_
+      - `Digistump Digispark Pro (16 MHz) (32 byte buffer) <http://digistump.com/products/109>`_
       - ATTINY167
       - 16 MHz
       - 16 Kb
       - 0.5 Kb
 
     * - ``digispark-pro64``
-      - `Digispark Pro (16 MHz) (64 byte buffer) <http://digistump.com/products/109>`_
+      - `Digistump Digispark Pro (16 MHz) (64 byte buffer) <http://digistump.com/products/109>`_
       - ATTINY167
       - 16 MHz
       - 16 Kb
       - 0.5 Kb
 
     * - ``digispark-tiny``
-      - `Digispark (Default - 16 MHz) <http://digistump.com/products/1>`_
+      - `Digistump Digispark (Default - 16 MHz) <http://digistump.com/products/1>`_
       - ATTINY85
       - 16 MHz
       - 8 Kb
@@ -428,6 +448,53 @@ Engduino
       - 32 Kb
       - 2.5 Kb
 
+LightUp
+~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``lightup``
+      - `LightUp <https://www.lightup.io/>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+LowPowerLab
+~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``moteino``
+      - `LowPowerLab Moteino <https://lowpowerlab.com/shop/moteino-r4>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``moteinomega``
+      - `LowPowerLab MoteinoMEGA <http://lowpowerlab.com/blog/2014/08/09/moteinomega-available-now/>`_
+      - ATMEGA1284P
+      - 16 MHz
+      - 128 Kb
+      - 16 Kb
+
 Microduino
 ~~~~~~~~~~
 
@@ -523,3 +590,255 @@ PanStamp
       - 8 MHz
       - 32 Kb
       - 2 Kb
+
+Quirkbot
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``quirkbot``
+      - `Quirkbot <http://quirkbot.com>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+RedBearLab
+~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``blend``
+      - `RedBearLab Blend <http://redbearlab.com/blend/>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``blendmicro16``
+      - `RedBearLab Blend Micro 3.3V/16MHz (overclock) <http://redbearlab.com/blendmicro/>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``blendmicro8``
+      - `RedBearLab Blend Micro 3.3V/8MHz <http://redbearlab.com/blendmicro/>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+RepRap
+~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``reprap_rambo``
+      - `RepRap RAMBo <http://reprap.org/wiki/Rambo>`_
+      - ATMEGA2560
+      - 16 MHz
+      - 256 Kb
+      - 8 Kb
+
+Sanguino
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``sanguino_atmega12848m``
+      - `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
+      - 16 MHz
+      - 128 Kb
+      - 16 Kb
+
+    * - ``sanguino_atmega644p``
+      - `Sanguino ATmega644P <https://code.google.com/p/sanguino/>`_
+      - ATMEGA644P
+      - 16 MHz
+      - 64 Kb
+      - 4 Kb
+
+SparkFun
+~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``sparkfun_digitalsandbox``
+      - `SparkFun Digital Sandbox <https://www.sparkfun.com/products/12651>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``sparkfun_fiov3``
+      - `SparkFun Fio V3 3.3V/8MHz <https://www.sparkfun.com/products/11520>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``sparkfun_makeymakey``
+      - `SparkFun Makey Makey <https://www.sparkfun.com/products/11511>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``sparkfun_megamini``
+      - `SparkFun Mega Pro Mini 3.3V <https://www.sparkfun.com/products/10743>`_
+      - ATMEGA2560
+      - 8 MHz
+      - 256 Kb
+      - 8 Kb
+
+    * - ``sparkfun_megapro16MHz``
+      - `SparkFun Mega Pro 5V/16MHz <https://www.sparkfun.com/products/11007>`_
+      - ATMEGA2560
+      - 16 MHz
+      - 256 Kb
+      - 8 Kb
+
+    * - ``sparkfun_megapro8MHz``
+      - `SparkFun Mega Pro 3.3V/8MHz <https://www.sparkfun.com/products/10744>`_
+      - ATMEGA2560
+      - 8 MHz
+      - 256 Kb
+      - 8 Kb
+
+    * - ``sparkfun_promicro16``
+      - `SparkFun Pro Micro 5V/16MHz <https://www.sparkfun.com/products/12640>`_
+      - ATMEGA32U4
+      - 16 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``sparkfun_promicro8``
+      - `SparkFun Pro Micro 3.3V/8MHz <https://www.sparkfun.com/products/12587>`_
+      - ATMEGA32U4
+      - 8 MHz
+      - 32 Kb
+      - 2.5 Kb
+
+    * - ``sparkfun_redboard``
+      - `SparkFun RedBoard <https://www.sparkfun.com/products/12757>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``uview``
+      - `SparkFun MicroView <https://www.sparkfun.com/products/12923>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
+
+TinyCircuits
+~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``tinyduino``
+      - `TinyCircuits TinyDuino Processor Board <https://tiny-circuits.com/tinyduino-processor-board.html>`_
+      - ATMEGA328P
+      - 8 MHz
+      - 32 Kb
+      - 2 Kb
+
+    * - ``tinylily``
+      - `TinyCircuits TinyLily Mini Processor <https://tiny-circuits.com/tiny-lily-mini-processor.html>`_
+      - ATMEGA328P
+      - 8 MHz
+      - 32 Kb
+      - 2 Kb
+
+WickedDevice
+~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``wildfirev2``
+      - `WickedDevice WildFire v2 [stk500] <http://shop.wickeddevice.com/resources/wildfire/#arduinoidesetup>`_
+      - ATMEGA1284P
+      - 16 MHz
+      - 128 Kb
+      - 16 Kb
+
+    * - ``wildfirev3``
+      - `WickedDevice WildFire v3 [optiboot] <http://shop.wickeddevice.com/resources/wildfire/>`_
+      - ATMEGA1284P
+      - 16 MHz
+      - 128 Kb
+      - 16 Kb

docs/platforms/atmelsam.rst

@@ -31,7 +31,7 @@ Packages
 
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/ivankravets/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the 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/platforms/creating_platform.rst

@@ -40,67 +40,82 @@ Packages
     :header-rows:  1
 
     * - Name
-      - Alias
       - Contents
-    * - ``toolchain-gccarmnoneeabi``
-      - toolchain
-      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded/>`_,
-        `GDB <http://www.gnu.org/software/gdb/>`_
-    * - ``toolchain-atmelavr``
-      - toolchain
-      - `avr-gcc <https://gcc.gnu.org/wiki/avr-gcc>`_,
-        `GDB <http://www.gnu.org/software/gdb/>`_,
-        `AVaRICE <http://avarice.sourceforge.net>`_,
-        `SimulAVR <http://www.nongnu.org/simulavr/>`_
-    * - ``toolchain-timsp430``
-      - toolchain
-      - `msp-gcc <http://sourceforge.net/projects/mspgcc/>`_,
-        `GDB <http://www.gnu.org/software/gdb/>`_
-    * - ``tool-avrdude``
-      - uploader
-      - `AVRDUDE <http://www.nongnu.org/avrdude/>`_
-    * - ``tool-bossac``
-      - uploader
-      - `BOSSA CLI <https://sourceforge.net/projects/b-o-s-s-a/>`_
-    * - ``tool-micronucleus``
-      - uploader
-      - `Micronucleus <https://github.com/micronucleus/micronucleus>`_
-    * - ``tool-mspdebug``
-      - uploader
-      - `MSPDebug <http://mspdebug.sourceforge.net>`_
-    * - ``tool-lm4flash``
-      - uploader
-      - `Flash Programmer <http://www.ti.com/tool/lmflashprogrammer>`_
-    * - ``tool-stlink``
-      - uploader
-      - `STLink <https://github.com/texane/stlink>`_
-    * - ``tool-teensy``
-      - uploader
-      - `Teensy Loader <https://www.pjrc.com/teensy/loader.html>`_
+
     * - ``framework-arduinoavr``
-      -
-      - `Arduino Wiring-based Framework (AVR Core, 1.6 branch) <http://arduino.cc/en/Reference/HomePage>`_
+      - `Arduino Wiring-based Framework (AVR Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
+
+    * - ``framework-arduinoespressif``
+      - `Arduino Wiring-based Framework (ESP8266 Core) <https://github.com/esp8266/Arduino>`_
+
+    * - ``framework-arduinomsp430``
+      - `Arduino Wiring-based Framework (MSP430 Core) <http://arduino.cc/en/Reference/HomePage>`_
+
     * - ``framework-arduinosam``
-      -
-      - `Arduino Wiring-based Framework (SAM Core, 1.6 branch) <http://arduino.cc/en/Reference/HomePage>`_
+      - `Arduino Wiring-based Framework (SAM Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
+
     * - ``framework-arduinoteensy``
-      -
       - `Arduino Wiring-based Framework <http://arduino.cc/en/Reference/HomePage>`_
-    * - ``framework-energiamsp430``
-      -
-      - `Energia Wiring-based Framework (MSP430 Core) <http://energia.nu/reference/>`_
-    * - ``framework-energiativa``
-      -
-      - `Energia Wiring-based Framework (LM4F Core)  <http://energia.nu/reference/>`_
+
     * - ``framework-cmsis``
-      -
       - `Vendor-independent hardware abstraction layer for the Cortex-M processor series <http://www.arm.com/products/processors/cortex-m/cortex-microcontroller-software-interface-standard.php>`_
+
+    * - ``framework-energiamsp430``
+      - `Energia Wiring-based Framework (MSP430 Core) <http://energia.nu/reference/>`_
+
+    * - ``framework-energiativa``
+      - `Energia Wiring-based Framework (LM4F Core) <http://energia.nu/reference/>`_
+
+    * - ``framework-libopencm3``
+      - `libOpenCM3 Framework <http://www.libopencm3.org/>`_
+
+    * - ``framework-mbed``
+      - `mbed Framework <http://mbed.org>`_
+
     * - ``framework-spl``
-      -
       - `Standard Peripheral Library for STM32 MCUs <http://www.st.com/web/catalog/tools/FM147/CL1794/SC961/SS1743/PF257890>`_
-    * - ``framework-opencm3``
-      -
-      - `libOpenCM3 Framework <http://www.libopencm3.org>`_
+
+    * - ``ldscripts``
+      - `Linker Scripts <https://sourceware.org/binutils/docs/ld/Scripts.html>`_
+
+    * - ``sdk-esp8266``
+      - `ESP8266 SDK <http://bbs.espressif.com>`_
+
+    * - ``tool-avrdude``
+      - `AVRDUDE <http://www.nongnu.org/avrdude/>`_
+
+    * - ``tool-bossac``
+      - `BOSSA CLI <https://sourceforge.net/projects/b-o-s-s-a/>`_
+
+    * - ``tool-esptool``
+      - `esptool-ck <https://github.com/igrr/esptool-ck>`_
+
+    * - ``tool-lm4flash``
+      - `Flash Programmer <http://www.ti.com/tool/lmflashprogrammer>`_
+
+    * - ``tool-micronucleus``
+      - `Micronucleus <https://github.com/micronucleus/micronucleus>`_
+
+    * - ``tool-mspdebug``
+      - `MSPDebug <http://mspdebug.sourceforge.net/>`_
+
+    * - ``tool-stlink``
+      - `ST-Link <https://github.com/texane/stlink>`_
+
+    * - ``tool-teensy``
+      - `Teensy Loader <https://www.pjrc.com/teensy/loader.html>`_
+
+    * - ``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/>`_
+
+    * - ``toolchain-gccarmnoneeabi``
+      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded>`_, `GDB <http://www.gnu.org/software/gdb/>`_
+
+    * - ``toolchain-timsp430``
+      - `msp-gcc <http://sourceforge.net/projects/mspgcc/>`_, `GDB <http://www.gnu.org/software/gdb/>`_
+
+    * - ``toolchain-xtensa``
+      - `xtensa-gcc <https://github.com/jcmvbkbc/gcc-xtensa>`_, `GDB <http://www.gnu.org/software/gdb/>`_
 
 .. _platform_creating_manifest_file:
 
@@ -238,7 +253,7 @@ base template of ``test-builder.py``.
     )
 
     # The source code of "platformio-build-tool" is here
-    # https://github.com/ivankravets/platformio/blob/develop/platformio/builder/tools/platformio.py
+    # https://github.com/platformio/platformio/blob/develop/platformio/builder/tools/platformio.py
 
     #
     # Target: Build executable and linkable firmware
@@ -265,9 +280,11 @@ base template of ``test-builder.py``.
 Please look into the examples with built-in scripts for the popular
 platforms:
 
-* `atmelavr.py <https://github.com/ivankravets/platformio/blob/develop/platformio/builder/scripts/atmelavr.py>`_
-* `timsp430.py <https://github.com/ivankravets/platformio/blob/develop/platformio/builder/scripts/timsp430.py>`_
-* `titiva.py <https://github.com/ivankravets/platformio/blob/develop/platformio/builder/scripts/titiva.py>`_
+* `baseavr.py <https://github.com/platformio/platformio/blob/develop/platformio/builder/scripts/baseavr.py>`_
+* `basearm.py <https://github.com/platformio/platformio/blob/develop/platformio/builder/scripts/basearm.py>`_
+* `atmelavr.py <https://github.com/platformio/platformio/blob/develop/platformio/builder/scripts/atmelavr.py>`_
+* `timsp430.py <https://github.com/platformio/platformio/blob/develop/platformio/builder/scripts/timsp430.py>`_
+* `ststm32.py <https://github.com/platformio/platformio/blob/develop/platformio/builder/scripts/ststm32.py>`_
 
 .. _platform_creating_installation:
 

docs/platforms/espressif.rst

@@ -0,0 +1,79 @@
+.. _platform_espressif:
+
+Platform ``espressif``
+======================
+Espressif Systems is a privately held fabless semiconductor company. They provide wireless communications and Wi-Fi chips which are widely used in mobile devices and the Internet of Things applications.
+
+For more detailed information please visit `vendor site <https://espressif.com/>`_.
+
+.. contents::
+
+Packages
+--------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Contents
+
+    * - ``ldscripts``
+      - `Linker Scripts <https://sourceware.org/binutils/docs/ld/Scripts.html>`_
+
+    * - ``sdk-esp8266``
+      - `ESP8266 SDK <http://bbs.espressif.com>`_
+
+    * - ``tool-esptool``
+      - `esptool-ck <https://github.com/igrr/esptool-ck>`_
+
+    * - ``framework-arduinoespressif``
+      - `Arduino Wiring-based Framework (ESP8266 Core) <https://github.com/esp8266/Arduino>`_
+
+    * - ``toolchain-xtensa``
+      - `xtensa-gcc <https://github.com/jcmvbkbc/gcc-xtensa>`_, `GDB <http://www.gnu.org/software/gdb/>`_
+
+.. warning::
+    **Linux Users:** Don't forget to install "udev" rules file
+    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
+
+
+
+Frameworks
+----------
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Description
+
+    * - :ref:`framework_arduino`
+      - Arduino Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
+
+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.
+
+Espressif
+~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``esp01``
+      - `Espressif ESP8266 board <https://nurdspace.nl/ESP8266>`_
+      - ESP8266
+      - 80 MHz
+      - 512 Kb
+      - 32 Kb

docs/platforms/freescalekinetis.rst

@@ -25,7 +25,7 @@ Packages
 
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/ivankravets/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the 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/platforms/index.rst

@@ -16,6 +16,7 @@ MCU, upload protocol or etc. Please use ``board`` option.
 
     atmelavr
     atmelsam
+    espressif
     freescalekinetis
     nordicnrf51
     nxplpc

docs/platforms/nordicnrf51.rst

@@ -25,7 +25,7 @@ Packages
 
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/ivankravets/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
+    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
 
 
 
@@ -144,7 +144,7 @@ SeeedStudio
       - RAM
 
     * - ``seeedTinyBLE``
-      - `Seeed Tiny BLE <http://developer.mbed.org/platforms/Seeed-Tiny-BLE/>`_
+      - `SeeedStudio Seeed Tiny BLE <http://developer.mbed.org/platforms/Seeed-Tiny-BLE/>`_
       - NRF51822
       - 16 MHz
       - 256 Kb

docs/platforms/nxplpc.rst

@@ -25,7 +25,7 @@ Packages
 
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/ivankravets/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
+    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
 
 
 
@@ -63,7 +63,7 @@ CQ Publishing
       - RAM
 
     * - ``lpc11u35_501``
-      - `TG-LPC11U35-501 <https://developer.mbed.org/platforms/TG-LPC11U35-501/>`_
+      - `CQ Publishing TG-LPC11U35-501 <https://developer.mbed.org/platforms/TG-LPC11U35-501/>`_
       - LPC11U35
       - 48 MHz
       - 64 Kb
@@ -83,21 +83,21 @@ Embedded Artists
       - RAM
 
     * - ``lpc11u35``
-      - `EA LPC11U35 QuickStart Board <https://developer.mbed.org/platforms/EA-LPC11U35/>`_
+      - `Embedded Artists LPC11U35 QuickStart Board <https://developer.mbed.org/platforms/EA-LPC11U35/>`_
       - LPC11U35
       - 48 MHz
       - 64 Kb
       - 10 Kb
 
     * - ``lpc4088``
-      - `EA LPC4088 QuickStart Board <https://developer.mbed.org/platforms/EA-LPC4088/>`_
+      - `Embedded Artists LPC4088 QuickStart Board <https://developer.mbed.org/platforms/EA-LPC4088/>`_
       - LPC4088
       - 120 MHz
       - 512 Kb
       - 96 Kb
 
     * - ``lpc4088_dm``
-      - `EA LPC4088 Display Module <https://developer.mbed.org/platforms/EA-LPC4088-Display-Module/>`_
+      - `Embedded Artists LPC4088 Display Module <https://developer.mbed.org/platforms/EA-LPC4088-Display-Module/>`_
       - LPC4088
       - 120 MHz
       - 512 Kb
@@ -117,7 +117,7 @@ NGX Technologies
       - RAM
 
     * - ``blueboard_lpc11u24``
-      - `BlueBoard-LPC11U24 <https://developer.mbed.org/platforms/BlueBoard-LPC11U24/>`_
+      - `NGX Technologies BlueBoard-LPC11U24 <https://developer.mbed.org/platforms/BlueBoard-LPC11U24/>`_
       - LPC11U24
       - 48 MHz
       - 32 Kb
@@ -137,21 +137,21 @@ NXP
       - RAM
 
     * - ``lpc11u24``
-      - `mbed LPC11U24 <https://developer.mbed.org/platforms/mbed-LPC11U24/>`_
+      - `NXP mbed LPC11U24 <https://developer.mbed.org/platforms/mbed-LPC11U24/>`_
       - LPC11U24
       - 48 MHz
       - 32 Kb
       - 8 Kb
 
     * - ``lpc1549``
-      - `LPCXpresso1549 <https://developer.mbed.org/platforms/LPCXpresso1549/>`_
+      - `NXP LPCXpresso1549 <https://developer.mbed.org/platforms/LPCXpresso1549/>`_
       - LPC1549
       - 72 MHz
       - 256 Kb
       - 36 Kb
 
     * - ``lpc1768``
-      - `mbed LPC1768 <http://developer.mbed.org/platforms/mbed-LPC1768/>`_
+      - `NXP mbed LPC1768 <http://developer.mbed.org/platforms/mbed-LPC1768/>`_
       - LPC1768
       - 96 MHz
       - 512 Kb
@@ -191,7 +191,7 @@ SeeedStudio
       - RAM
 
     * - ``seeeduinoArchPro``
-      - `Seeeduino-Arch-Pro <https://developer.mbed.org/platforms/Seeeduino-Arch-Pro/>`_
+      - `SeeedStudio Seeeduino-Arch-Pro <https://developer.mbed.org/platforms/Seeeduino-Arch-Pro/>`_
       - LPC1768
       - 96 MHz
       - 512 Kb
@@ -211,7 +211,7 @@ Solder Splash Labs
       - RAM
 
     * - ``dipcortexm0``
-      - `DipCortex M0 <https://developer.mbed.org/platforms/DipCortex-M0/>`_
+      - `Solder Splash Labs DipCortex M0 <https://developer.mbed.org/platforms/DipCortex-M0/>`_
       - LPC11U24
       - 50 MHz
       - 32 Kb
@@ -231,7 +231,7 @@ Switch Science
       - RAM
 
     * - ``lpc1114fn28``
-      - `mbed LPC1114FN28 <https://developer.mbed.org/platforms/LPC1114FN28/>`_
+      - `Switch Science mbed LPC1114FN28 <https://developer.mbed.org/platforms/LPC1114FN28/>`_
       - LPC1114FN28
       - 48 MHz
       - 32 Kb

docs/platforms/ststm32.rst

@@ -40,7 +40,7 @@ Packages
 
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/ivankravets/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
+    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
 
 
 
@@ -87,56 +87,56 @@ ST
       - RAM
 
     * - ``disco_f051r8``
-      - `STM32F0DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF253215>`_
+      - `ST STM32F0DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF253215>`_
       - STM32F051R8T6
       - 48 MHz
       - 64 Kb
       - 8 Kb
 
     * - ``disco_f100rb``
-      - `STM32VLDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF250863>`_
+      - `ST STM32VLDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF250863>`_
       - STM32F100RBT6
       - 24 MHz
       - 128 Kb
       - 8 Kb
 
     * - ``disco_f303vc``
-      - `STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
+      - `ST STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
       - STM32F303VCT6
       - 72 MHz
       - 256 Kb
       - 48 Kb
 
     * - ``disco_f334c8``
-      - `32F3348DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF260318>`_
+      - `ST 32F3348DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF260318>`_
       - STM32F334C8T6
       - 72 MHz
       - 64 Kb
       - 16 Kb
 
     * - ``disco_f401vc``
-      - `32F401CDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF259098>`_
+      - `ST 32F401CDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF259098>`_
       - STM32F401VCT6
       - 84 MHz
       - 256 Kb
       - 64 Kb
 
     * - ``disco_f407vg``
-      - `STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
+      - `ST STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
       - STM32F407VGT6
       - 168 MHz
       - 1024 Kb
       - 128 Kb
 
     * - ``disco_f429zi``
-      - `32F429IDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF259090>`_
+      - `ST 32F429IDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF259090>`_
       - STM32F429ZIT6
       - 180 MHz
       - 2048 Kb
       - 256 Kb
 
     * - ``disco_l152rb``
-      - `STM32LDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF258515>`_
+      - `ST STM32LDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF258515>`_
       - STM32L152RBT6
       - 32 MHz
       - 128 Kb

docs/platforms/teensy.rst

@@ -34,7 +34,7 @@ Packages
 
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/ivankravets/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
+    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
 
 
 
@@ -98,3 +98,10 @@ Teensy
       - 72 MHz
       - 256 Kb
       - 64 Kb
+
+    * - ``teensylc``
+      - `Teensy LC <http://www.pjrc.com/teensy/teensyLC.html>`_
+      - MKL26Z64
+      - 48 MHz
+      - 64 Kb
+      - 8 Kb

docs/platforms/timsp430.rst

@@ -31,7 +31,7 @@ Packages
 
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/ivankravets/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
+    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
 
 
 
@@ -92,49 +92,49 @@ TI
       - RAM
 
     * - ``lpmsp430f5529``
-      - `LaunchPad w/ msp430f5529 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
+      - `TI LaunchPad w/ msp430f5529 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
       - MSP430F5529
       - 16 MHz
       - 128 Kb
       - 1 Kb
 
     * - ``lpmsp430f5529_25``
-      - `LaunchPad w/ msp430f5529 (25MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
+      - `TI LaunchPad w/ msp430f5529 (25MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
       - MSP430F5529
       - 25 MHz
       - 128 Kb
       - 1 Kb
 
     * - ``lpmsp430fr5739``
-      - `FraunchPad w/ msp430fr5739 <http://www.ti.com/tool/msp-exp430fr5739>`_
+      - `TI FraunchPad w/ msp430fr5739 <http://www.ti.com/tool/msp-exp430fr5739>`_
       - MSP430FR5739
       - 16 MHz
       - 16 Kb
       - 1 Kb
 
     * - ``lpmsp430fr5969``
-      - `LaunchPad w/ msp430fr5969 <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430fr5969.html>`_
+      - `TI LaunchPad w/ msp430fr5969 <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430fr5969.html>`_
       - MSP430FR5969
       - 8 MHz
       - 64 Kb
       - 1 Kb
 
     * - ``lpmsp430g2231``
-      - `LaunchPad w/ msp430g2231 (1 MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
+      - `TI LaunchPad w/ msp430g2231 (1 MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
       - MSP430G2231
       - 1 MHz
       - 2 Kb
       - 0.125 Kb
 
     * - ``lpmsp430g2452``
-      - `LaunchPad w/ msp430g2452 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
+      - `TI LaunchPad w/ msp430g2452 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
       - MSP430G2452
       - 16 MHz
       - 8 Kb
       - 0.25 Kb
 
     * - ``lpmsp430g2553``
-      - `LaunchPad w/ msp430g2553 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
+      - `TI LaunchPad w/ msp430g2553 (16MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
       - MSP430G2553
       - 16 MHz
       - 16 Kb

docs/platforms/titiva.rst

@@ -34,7 +34,7 @@ Packages
 
 .. warning::
     **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/ivankravets/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
+    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
 
 
 
@@ -75,21 +75,21 @@ TI
       - RAM
 
     * - ``lplm4f120h5qr``
-      - `LaunchPad (Stellaris) w/ lm4f120 (80MHz) <http://www.ti.com/tool/ek-lm4f120xl>`_
+      - `TI LaunchPad (Stellaris) w/ lm4f120 (80MHz) <http://www.ti.com/tool/ek-lm4f120xl>`_
       - LPLM4F120H5QR
       - 80 MHz
       - 256 Kb
       - 32 Kb
 
     * - ``lptm4c1230c3pm``
-      - `LaunchPad (Tiva C) w/ tm4c123 (80MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c123gxl.html>`_
+      - `TI LaunchPad (Tiva C) w/ tm4c123 (80MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c123gxl.html>`_
       - LPTM4C1230C3PM
       - 80 MHz
       - 256 Kb
       - 32 Kb
 
     * - ``lptm4c1294ncpdt``
-      - `LaunchPad (Tiva C) w/ tm4c129 (120MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c1294xl.html>`_
+      - `TI LaunchPad (Tiva C) w/ tm4c129 (120MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c1294xl.html>`_
       - LPTM4C1294NCPDT
       - 120 MHz
       - 1024 Kb

docs/projectconf.rst

@@ -73,7 +73,7 @@ This option can be overridden by global environment variable
 .. note::
     This option is useful for people who migrate from Arduino/Energia IDEs where
     source directory should have the same name like the main source file.
-    See `example <https://github.com/ivankravets/platformio/tree/develop/examples/atmelavr-and-arduino/arduino-own-src_dir>`__ project with own source directory.
+    See `example <https://github.com/platformio/platformio/tree/develop/examples/atmelavr-and-arduino/arduino-own-src_dir>`__ project with own source directory.
 
 .. _projectconf_pio_envs_dir:
 
@@ -329,7 +329,7 @@ Examples
 
 .. note::
     A full list with project examples can be found in
-    `PlatformIO Repository <https://github.com/ivankravets/platformio/tree/develop/examples>`_.
+    `PlatformIO Repository <https://github.com/platformio/platformio/tree/develop/examples>`_.
 
 1. :ref:`platform_atmelavr`: Arduino UNO board with auto pre-configured
    ``board_*`` and ``upload_*`` options (use only ``board`` option) and Arduino

docs/quickstart.rst

@@ -58,7 +58,7 @@ Change working directory to the project's root where is located
 If you don't have installed required platforms, then *PlatformIO* will propose
 you to install them automatically.
 
-Further examples can be found in `PlatformIO Repository <https://github.com/ivankravets/platformio/tree/develop/examples>`_.
+Further examples can be found in `PlatformIO Repository <https://github.com/platformio/platformio/tree/develop/examples>`_.
 
 Also, for more detailed information as for commands please go to
 :ref:`userguide` sections.

docs/userguide/cmd_list.rst

@@ -34,7 +34,10 @@ Examples
     $ platformio list
     atmelavr    with packages: toolchain-atmelavr, tool-avrdude, framework-arduinoavr, tool-micronucleus
     atmelsam    with packages: framework-arduinosam, ldscripts, toolchain-gccarmnoneeabi, tool-bossac
-    stm32       with packages: toolchain-gccarmnoneeabi, tool-stlink, framework-spl, framework-cmsis, framework-opencm3, ldscripts
+    freescalekinetis with packages: framework-mbed, toolchain-gccarmnoneeabi
+    nordicnrf51 with packages: framework-mbed, toolchain-gccarmnoneeabi
+    nxplpc      with packages: framework-mbed, toolchain-gccarmnoneeabi
+    ststm32     with packages: framework-libopencm3, toolchain-gccarmnoneeabi, tool-stlink, framework-spl, framework-cmsis, framework-mbed, ldscripts
     teensy      with packages: toolchain-atmelavr, ldscripts, framework-arduinoteensy, toolchain-gccarmnoneeabi, tool-teensy
-    timsp430    with packages: toolchain-timsp430, tool-mspdebug, framework-energiamsp430
-    titiva      with packages: ldscripts, toolchain-gccarmnoneeabi, tool-lm4flash, framework-opencm3, framework-energiativa
+    timsp430    with packages: toolchain-timsp430, tool-mspdebug, framework-energiamsp430, framework-arduinomsp430
+    titiva      with packages: ldscripts, framework-libopencm3, toolchain-gccarmnoneeabi, tool-lm4flash, framework-energiativa

docs/userguide/cmd_run.rst

@@ -42,7 +42,7 @@ Upload port of embedded board. To print all available ports use
 Examples
 --------
 
-1. Process `Wiring Blink Example <https://github.com/ivankravets/platformio/tree/develop/examples/wiring-blink>`_
+1. Process `Wiring Blink Example <https://github.com/platformio/platformio/tree/develop/examples/wiring-blink>`_
 
 .. code-block::   bash
 

docs/userguide/lib/cmd_register.rst

@@ -10,7 +10,7 @@ Usage
 
 .. code-block:: bash
 
-    platformio lib regiter [HTTP_URL_TO_LIBRARY.JSON]
+    platformio lib register [HTTP_URL_TO_LIBRARY.JSON]
 
 
 Description

examples/atmelavr-and-arduino/adafruit-blink/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/atmelavr-and-arduino/arduino-external-libs/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/atmelavr-and-arduino/arduino-internal-libs/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/atmelavr-and-arduino/arduino-own-src_dir/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/atmelavr-and-arduino/atmelavr-native-blink/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/atmelavr-and-arduino/digitstump-mouse/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/atmelavr-and-arduino/engduino-magnetometer/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/atmelavr-and-arduino/panstamp-blink/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/espressif/esp8266-native/README.rst

@@ -0,0 +1,21 @@
+How to build PlatformIO based project
+=====================================
+
+1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
+3. Extract ZIP archive
+4. Run these commands:
+
+.. code-block:: bash
+
+    # Change directory to example
+    > cd platformio-develop/examples/espressif/esp8266-native
+
+    # Process example project
+    > platformio run
+
+    # Upload firmware
+    > platformio run --target upload
+
+    # Clean build files
+    > platformio run --target clean

examples/espressif/esp8266-native/platformio.ini

@@ -0,0 +1,22 @@
+#
+# 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.
+
+# Simple and base environment
+# [env:mybaseenv]
+# platform = %INSTALLED_PLATFORM_NAME_HERE%
+# framework =
+# board =
+#
+# Automatic targets - enable auto-uploading
+# targets = upload
+
+[env:esp01_8266]
+platform = espressif
+board = esp01

examples/espressif/esp8266-native/src/user_config.h

@@ -0,0 +1,5 @@
+#ifndef __USER_CONFIG_H__
+#define __USER_CONFIG_H__
+
+#endif
+

examples/espressif/esp8266-native/src/user_main.c

@@ -0,0 +1,33 @@
+/******************************************************************************
+ * Copyright 2013-2014 Espressif Systems (Wuxi)
+ *
+ * FileName: user_main.c
+ *
+ * Description: entry file of user application
+ *
+ * Modification history:
+ *     2014/1/1, v1.0 create this file.
+*******************************************************************************/
+#include "ets_sys.h"
+#include "osapi.h"
+
+#include "user_interface.h"
+#include "smartconfig.h"
+
+void ICACHE_FLASH_ATTR
+smartconfig_done(void *data)
+{
+	struct station_config *sta_conf = data;
+
+	wifi_station_set_config(sta_conf);
+	wifi_station_disconnect();
+	wifi_station_connect();
+}
+
+void user_init(void)
+{
+    os_printf("SDK version:%s\n", system_get_sdk_version());
+
+    wifi_set_opmode(STATION_MODE);
+    smartconfig_start(SC_TYPE_AIRKISS, smartconfig_done);
+}

examples/espressif/esp8266-webserver/README.rst

@@ -0,0 +1,21 @@
+How to build PlatformIO based project
+=====================================
+
+1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
+3. Extract ZIP archive
+4. Run these commands:
+
+.. code-block:: bash
+
+    # Change directory to example
+    > cd platformio-develop/examples/espressif/esp8266-webserver
+
+    # Process example project
+    > platformio run
+
+    # Upload firmware
+    > platformio run --target upload
+
+    # Clean build files
+    > platformio run --target clean

examples/espressif/esp8266-webserver/platformio.ini

@@ -0,0 +1,23 @@
+#
+# 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.
+
+# Simple and base environment
+# [env:mybaseenv]
+# platform = %INSTALLED_PLATFORM_NAME_HERE%
+# framework =
+# board =
+#
+# Automatic targets - enable auto-uploading
+# targets = upload
+
+[env:esp01_8266]
+platform = espressif
+framework = arduino
+board = esp01

examples/espressif/esp8266-webserver/src/HelloServer.ino

@@ -0,0 +1,54 @@
+#include <ESP8266WiFi.h>
+#include <WiFiClient.h>
+#include <ESP8266WebServer.h>
+ 
+const char* ssid = "*****";
+const char* password = "*****";
+
+
+ESP8266WebServer server(80);
+ 
+const int led = 13;
+ 
+void handle_root() {
+  digitalWrite(led, 1);
+  server.send(200, "text/plain", "hello from esp8266!");
+  delay(100);
+  digitalWrite(led, 0);
+}
+ 
+void setup(void)
+{
+  Serial.begin(115200);
+  pinMode(led, OUTPUT);
+  digitalWrite(led, 0);
+
+  // Connect to WiFi network
+  WiFi.begin(ssid, password);
+  Serial.println("");
+
+  // Wait for connection
+  while (WiFi.status() != WL_CONNECTED) {
+    delay(500);
+    Serial.print(".");
+  }
+  Serial.println("");
+  Serial.print("Connected to ");
+  Serial.println(ssid);
+  Serial.print("IP address: ");
+  Serial.println(WiFi.localIP());
+   
+  server.on("/", handle_root);
+  
+  server.on("/inline", [](){
+    server.send(200, "text/plain", "this works as well");
+  });
+  
+  server.begin();
+  Serial.println("HTTP server started");
+}
+ 
+void loop(void)
+{
+  server.handleClient();
+} 

examples/espressif/esp8266-wifiscan/README.rst

@@ -0,0 +1,21 @@
+How to build PlatformIO based project
+=====================================
+
+1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
+3. Extract ZIP archive
+4. Run these commands:
+
+.. code-block:: bash
+
+    # Change directory to example
+    > cd platformio-develop/examples/espressif/esp8266-wifiscan
+
+    # Process example project
+    > platformio run
+
+    # Upload firmware
+    > platformio run --target upload
+
+    # Clean build files
+    > platformio run --target clean

examples/espressif/esp8266-wifiscan/platformio.ini

@@ -0,0 +1,23 @@
+#
+# 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.
+
+# Simple and base environment
+# [env:mybaseenv]
+# platform = %INSTALLED_PLATFORM_NAME_HERE%
+# framework =
+# board =
+#
+# Automatic targets - enable auto-uploading
+# targets = upload
+
+[env:esp01_8266]
+platform = espressif
+framework = arduino
+board = esp01

examples/espressif/esp8266-wifiscan/src/WiFiScan.ino

@@ -0,0 +1,48 @@
+/*
+ *  This sketch demonstrates how to scan WiFi networks. 
+ *  The API is almost the same as with the WiFi Shield library, 
+ *  the most obvious difference being the different file you need to include:
+ */
+#include "ESP8266WiFi.h"
+
+void setup() {
+  Serial.begin(115200);
+
+  // Set WiFi to station mode and disconnect from an AP if it was previously connected
+  WiFi.mode(WIFI_STA);
+  WiFi.disconnect();
+  delay(100);
+
+  Serial.println("Setup done");
+}
+
+void loop() {
+  Serial.println("scan start");
+
+  // WiFi.scanNetworks will return the number of networks found
+  int n = WiFi.scanNetworks();
+  Serial.println("scan done");
+  if (n == 0)
+    Serial.println("no networks found");
+  else
+  {
+    Serial.print(n);
+    Serial.println(" networks found");
+    for (int i = 0; i < n; ++i)
+    {
+      // Print SSID and RSSI for each network found
+      Serial.print(i + 1);
+      Serial.print(": ");
+      Serial.print(WiFi.SSID(i));
+      Serial.print(" (");
+      Serial.print(WiFi.RSSI(i));
+      Serial.print(")");
+      Serial.println((WiFi.encryptionType(i) == ENC_TYPE_NONE)?" ":"*");
+      delay(10);
+    }
+  }
+  Serial.println("");
+
+  // Wait a bit before scanning again
+  delay(5000);
+}

examples/ide/qtcreator/platformio.ini

@@ -0,0 +1,23 @@
+#
+# 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.
+
+# Simple and base environment
+# [env:mybaseenv]
+# platform = %INSTALLED_PLATFORM_NAME_HERE%
+# framework =
+# board =
+#
+# Automatic targets - enable auto-uploading
+# targets = upload
+
+[env:arduino_uno]
+platform = atmelavr
+framework = arduino
+board = uno

examples/ide/qtcreator/platformio.pro

@@ -0,0 +1,19 @@
+win32 {
+    HOMEDIR += $$(USERPROFILE)
+}
+else {
+    HOMEDIR += $$(PWD)
+}
+
+INCLUDEPATH += "$$HOMEDIR/.platformio/packages/framework-arduinoavr/cores/arduino"
+INCLUDEPATH += "$$HOMEDIR/.platformio/packages/toolchain-atmelavr/avr/include"
+
+win32:INCLUDEPATH ~= s,/,\\,g
+
+# DEFINES += __AVR_ATmega328__
+
+OTHER_FILES += \
+    platformio.ini
+
+SOURCES += \
+    src/main.c

examples/ide/qtcreator/src/main.c

@@ -0,0 +1,25 @@
+#include "Arduino.h"
+/*
+  Blink
+  Turns on an LED on for one second, then off for one second, repeatedly.
+ 
+  This example code is in the public domain.
+*/
+ 
+int led = 1; // blink 'digital' pin 1 - AKA the built in red LED
+
+// the setup routine runs once when you press reset:
+void setup() {
+  // initialize the digital pin as an output.
+  pinMode(led, OUTPUT);
+
+}
+
+// the loop routine runs over and over again forever:
+void loop() {
+    digitalWrite(led, HIGH); 
+    delay(1000);
+    digitalWrite(led, LOW);
+    delay(1000);
+}
+    

examples/ide/sublime-text/platformio.ini

@@ -0,0 +1,23 @@
+#
+# 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.
+
+# Simple and base environment
+# [env:mybaseenv]
+# platform = %INSTALLED_PLATFORM_NAME_HERE%
+# framework =
+# board =
+#
+# Automatic targets - enable auto-uploading
+# targets = upload
+
+[env:flora8]
+platform = atmelavr
+framework = arduino
+board = flora8

examples/ide/sublime-text/platformio.sublime-project

@@ -0,0 +1,43 @@
+{
+	"build_systems":
+	[
+		{
+			"cmd":
+			[
+				"platformio",
+				"run"
+			],
+			"name": "PlatformIO",
+			"variants":
+			[
+				{
+					"cmd":
+					[
+						"platformio",
+						"run",
+						"-t",
+						"clean"
+					],
+					"name": "Clean"
+				},
+				{
+					"cmd":
+					[
+						"platformio",
+						"run",
+						"-t",
+						"upload"
+					],
+					"name": "Upload"
+				}
+			],
+			"working_dir": "${project_path:${folder}}"
+		}
+	],
+	"folders":
+	[
+		{
+			"path": "."
+		}
+	]
+}

examples/ide/sublime-text/src/Blink.pde

@@ -0,0 +1,24 @@
+/*
+  Blink
+  Turns on an LED on for one second, then off for one second, repeatedly.
+ 
+  This example code is in the public domain.
+*/
+ 
+int led = 1; // blink 'digital' pin 1 - AKA the built in red LED
+
+// the setup routine runs once when you press reset:
+void setup() {
+  // initialize the digital pin as an output.
+  pinMode(led, OUTPUT);
+
+}
+
+// the loop routine runs over and over again forever:
+void loop() {
+    digitalWrite(led, HIGH); 
+    delay(1000);
+    digitalWrite(led, LOW);
+    delay(1000);
+}
+    

examples/ide/visual-studio/blink.vcxproj

@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project DefaultTargets="Build" ToolsVersion="12.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <ItemGroup Label="ProjectConfigurations">
+    <ProjectConfiguration Include="Debug|Win32">
+      <Configuration>Debug</Configuration>
+      <Platform>Win32</Platform>
+    </ProjectConfiguration>
+    <ProjectConfiguration Include="Release|Win32">
+      <Configuration>Release</Configuration>
+      <Platform>Win32</Platform>
+    </ProjectConfiguration>
+  </ItemGroup>
+  <PropertyGroup Label="Globals">
+    <ProjectGuid>{0FA9C3A8-452B-41EF-A418-9102B170F49F}</ProjectGuid>
+    <Keyword>MakeFileProj</Keyword>
+  </PropertyGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" Label="Configuration">
+    <ConfigurationType>Makefile</ConfigurationType>
+    <UseDebugLibraries>true</UseDebugLibraries>
+    <PlatformToolset>v120</PlatformToolset>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" Label="Configuration">
+    <ConfigurationType>Makefile</ConfigurationType>
+    <UseDebugLibraries>false</UseDebugLibraries>
+    <PlatformToolset>v120</PlatformToolset>
+  </PropertyGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
+  <ImportGroup Label="ExtensionSettings">
+  </ImportGroup>
+  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
+    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
+  </ImportGroup>
+  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
+    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
+  </ImportGroup>
+  <PropertyGroup Label="UserMacros" />
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
+    <NMakeBuildCommandLine>platformio run</NMakeBuildCommandLine>
+    <NMakeCleanCommandLine>platformio run -t clean</NMakeCleanCommandLine>
+    <NMakePreprocessorDefinitions>WIN32;_DEBUG;$(NMakePreprocessorDefinitions)</NMakePreprocessorDefinitions>
+    <NMakeIncludeSearchPath>$(HOMEDRIVE)$(HOMEPATH)\.platformio\packages\toolchain-atmelavr\avr\include;$(HOMEDRIVE)$(HOMEPATH)\.platformio\packages\framework-arduinoavr\cores\arduino;$(NMakeIncludeSearchPath)</NMakeIncludeSearchPath>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
+    <NMakeBuildCommandLine>platformio run</NMakeBuildCommandLine>
+    <NMakeCleanCommandLine>platformio run -t clean</NMakeCleanCommandLine>
+    <NMakePreprocessorDefinitions>WIN32;NDEBUG;$(NMakePreprocessorDefinitions)</NMakePreprocessorDefinitions>
+    <NMakeIncludeSearchPath>$(HOMEDRIVE)$(HOMEPATH)\.platformio\packages\toolchain-atmelavr\avr\include;$(HOMEDRIVE)$(HOMEPATH)\.platformio\packages\framework-arduinoavr\cores\arduino;$(NMakeIncludeSearchPath)</NMakeIncludeSearchPath>
+  </PropertyGroup>
+  <ItemDefinitionGroup>
+  </ItemDefinitionGroup>
+  <ItemGroup>
+    <Text Include="readme.txt" />
+  </ItemGroup>
+  <ItemGroup>
+    <None Include="platformio.ini" />
+    <None Include="src\blink.pde" />
+  </ItemGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
+  <ImportGroup Label="ExtensionTargets">
+  </ImportGroup>
+</Project>

examples/ide/visual-studio/blink.vcxproj.filters

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <ItemGroup>
+    <Filter Include="Source Files">
+      <UniqueIdentifier>{4FC737F1-C7A5-4376-A066-2A32D752A2FF}</UniqueIdentifier>
+      <Extensions>cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx</Extensions>
+    </Filter>
+    <Filter Include="Header Files">
+      <UniqueIdentifier>{93995380-89BD-4b04-88EB-625FBE52EBFB}</UniqueIdentifier>
+      <Extensions>h;hh;hpp;hxx;hm;inl;inc;xsd</Extensions>
+    </Filter>
+    <Filter Include="Resource Files">
+      <UniqueIdentifier>{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}</UniqueIdentifier>
+      <Extensions>rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx;tiff;tif;png;wav;mfcribbon-ms</Extensions>
+    </Filter>
+    <Filter Include="Source Files\src">
+      <UniqueIdentifier>{cad450ef-1a84-42d4-a5b5-a1736b8833d3}</UniqueIdentifier>
+    </Filter>
+  </ItemGroup>
+  <ItemGroup>
+    <Text Include="readme.txt" />
+  </ItemGroup>
+  <ItemGroup>
+    <None Include="platformio.ini" />
+    <None Include="src\blink.pde">
+      <Filter>Source Files\src</Filter>
+    </None>
+  </ItemGroup>
+</Project>

examples/ide/visual-studio/platformio.ini

@@ -0,0 +1,23 @@
+#
+# 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.
+
+# Simple and base environment
+# [env:mybaseenv]
+# platform = %INSTALLED_PLATFORM_NAME_HERE%
+# framework =
+# board =
+#
+# Automatic targets - enable auto-uploading
+# targets = upload
+
+[env:arduino_uno]
+platform = atmelavr
+framework = arduino
+board = uno

examples/ide/visual-studio/src/blink.pde

@@ -0,0 +1,24 @@
+/*
+  Blink
+  Turns on an LED on for one second, then off for one second, repeatedly.
+ 
+  This example code is in the public domain.
+*/
+ 
+int led = 1; // blink 'digital' pin 1 - AKA the built in red LED
+
+// the setup routine runs once when you press reset:
+void setup() {
+  // initialize the digital pin as an output.
+  pinMode(led, OUTPUT);
+
+}
+
+// the loop routine runs over and over again forever:
+void loop() {
+    digitalWrite(led, HIGH); 
+    delay(1000);
+    digitalWrite(led, LOW);
+    delay(1000);
+}
+    

examples/mbed/mbed-blink/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/mbed/mbed-blink/platformio.ini

@@ -41,3 +41,9 @@ board = frdm_kl25z
 platform = ststm32
 framework = mbed
 board = nucleo_f401re
+
+# Teensy Platform
+[env:teensy31]
+platform = teensy
+framework = mbed
+board = teensy31

examples/mbed/mbed-dsp/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/mbed/mbed-http-client/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/mbed/mbed-rtos/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 ====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/mbed/mbed-serial/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/stm32/stm32-cmsis-blink/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands:
 

examples/stm32/stm32-opencm3-blink/README.rst

@@ -2,7 +2,7 @@ How to build PlatformIO based project
 =====================================
 
 1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
-2. Download `source code with examples <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
 3. Extract ZIP archive
 4. Run these commands: