Added CONFIG += c++17 to get correct autocompletions

Bump version to 5.0.2

.coveragerc

@@ -0,0 +1,21 @@
+# Copyright (c) 2014-present PlatformIO <contact@platformio.org>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+[report]
+# Regexes for lines to exclude from consideration
+exclude_lines =
+    pragma: no cover
+    def __repr__
+    raise AssertionError
+    raise NotImplementedError

.github/FUNDING.yml

@@ -0,0 +1 @@
+custom: https://platformio.org/donate

.github/ISSUE_TEMPLATE.md

@@ -1,17 +1,28 @@
 What kind of issue is this?
 
-- [ ] Question. This issue tracker is not the place for questions. If you want to ask how to do
-      something, or to understand why something isn't working the way you expect it to, use
-      our Community Forums https://community.platformio.org
+- [ ] **Question**.
+      This issue tracker is not the place for questions. If you want to ask how to do something,
+      or to understand why something isn't working the way you expect it to, 
+      use [Community Forums](https://community.platformio.org) or [Premium Support](https://platformio.org/support)
 
-- [ ] Feature Request. Start by telling us what problem you’re trying to solve. Often a solution
+- [ ] **PlatformIO IDE**.
+      All issues related to PlatformIO IDE should be reported to appropriate repository:
+      [PlatformIO IDE for Atom](https://github.com/platformio/platformio-atom-ide/issues) or
+      [PlatformIO IDE for VSCode](https://github.com/platformio/platformio-vscode-ide/issues)
+
+- [ ] **Development Platform or Board**.
+      All issues (building, uploading, adding new boards, etc.) related to PlatformIO development platforms
+      should be reported to appropriate repository related to your hardware
+      https://github.com/topics/platformio-platform
+
+- [ ] **Feature Request**.
+      Start by telling us what problem you’re trying to solve. Often a solution
       already exists! Don’t send pull requests to implement new features without first getting our
       support. Sometimes we leave features out on purpose to keep the project small.
 
-- [ ] PlatformIO IDE. All issues related to PlatformIO IDE should be reported to appropriate repository
-      https://github.com/platformio/platformio-atom-ide/issues
+- [ ] **PlatformIO Core**.
+      If you’ve found a bug, please provide an information below.
 
-- [ ] Bug report. If you’ve found a bug, please provide information below.
 
 *You can erase any parts of this template not applicable to your Issue.*
 

.github/workflows/core.yml

@@ -0,0 +1,44 @@
+name: Core
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: [2.7, 3.7, 3.8]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          submodules: "recursive"
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v1
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+
+      - name: Python Lint
+        run: |
+          tox -e lint
+      - name: Integration Tests
+        env:
+          TEST_EMAIL_LOGIN: ${{ secrets.TEST_EMAIL_LOGIN }}
+          TEST_EMAIL_PASSWORD: ${{ secrets.TEST_EMAIL_PASSWORD }}
+          TEST_EMAIL_IMAP_SERVER: ${{ secrets.TEST_EMAIL_IMAP_SERVER }}
+        run: |
+          tox -e testcore
+
+      - name: Slack Notification
+        uses: homoluctus/slatify@master
+        if: failure()
+        with:
+          type: ${{ job.status }}
+          job_name: '*Core*'
+          commit: true
+          url: ${{ secrets.SLACK_BUILD_WEBHOOK }}

.github/workflows/docs.yml

@@ -0,0 +1,32 @@
+name: Docs
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          submodules: "recursive"
+      - name: Set up Python
+        uses: actions/setup-python@v1
+        with:
+          python-version: 3.7
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+
+      - name: Build docs
+        run: |
+          tox -e docs
+
+      - name: Slack Notification
+        uses: homoluctus/slatify@master
+        if: failure()
+        with:
+          type: ${{ job.status }}
+          job_name: '*Docs*'
+          commit: true
+          url: ${{ secrets.SLACK_BUILD_WEBHOOK }}

.github/workflows/examples.yml

@@ -0,0 +1,64 @@
+name: Examples
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-16.04, windows-latest, macos-latest]
+        python-version: [2.7, 3.7]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          submodules: "recursive"
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v1
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+
+      - name: Run on Linux
+        if: startsWith(matrix.os, 'ubuntu')
+        env:
+          PIO_INSTALL_DEVPLATFORMS_IGNORE: "ststm8,infineonxmc,siwigsm,intel_mcs51,aceinna_imu"
+        run: |
+          # ChipKIT issue: install 32-bit support for GCC PIC32
+          sudo apt-get install libc6-i386
+          # Free space
+          sudo apt clean
+          docker rmi $(docker image ls -aq)
+          df -h
+          # Run
+          tox -e testexamples
+
+      - name: Run on macOS
+        if: startsWith(matrix.os, 'macos')
+        env:
+          PIO_INSTALL_DEVPLATFORMS_IGNORE: "ststm8,infineonxmc,siwigsm,microchippic32,gd32v,nuclei,lattice_ice40"
+        run: |
+          df -h
+          tox -e testexamples
+
+      - name: Run on Windows
+        if: startsWith(matrix.os, 'windows')
+        env:
+          PLATFORMIO_CORE_DIR: C:/pio
+          PLATFORMIO_WORKSPACE_DIR: C:/pio-workspace/$PROJECT_HASH
+          PIO_INSTALL_DEVPLATFORMS_IGNORE: "ststm8,infineonxmc,siwigsm,riscv_gap"
+        run: |
+          tox -e testexamples
+
+      - name: Slack Notification
+        uses: homoluctus/slatify@master
+        if: failure()
+        with:
+          type: ${{ job.status }}
+          job_name: '*Examples*'
+          commit: true
+          url: ${{ secrets.SLACK_BUILD_WEBHOOK }}

.gitignore

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

.gitmodules

@@ -1,3 +1,7 @@
 [submodule "examples"]
 	path = examples
 	url = https://github.com/platformio/platformio-examples.git
+[submodule "docs"]
+	path = docs
+	url = https://github.com/platformio/platformio-docs.git
+	branch = develop

.isort.cfg

@@ -1,3 +1,3 @@
 [settings]
-line_length=79
-known_third_party=bottle,click,lockfile,pytest,requests,serial,SCons
+line_length=88
+known_third_party=OpenSSL, SCons, autobahn, jsonrpc, twisted, zope

.pylintrc

@@ -1,23 +1,22 @@
+[REPORTS]
+output-format=colorized
+
 [MESSAGES CONTROL]
+disable=
+    bad-continuation,
+    bad-whitespace,
+    missing-docstring,
+    ungrouped-imports,
+    invalid-name,
+    cyclic-import,
+    duplicate-code,
+    superfluous-parens,
+    too-few-public-methods,
+    useless-object-inheritance,
+    useless-import-alias,
+    fixme,
+    bad-option-value,
 
-# Only show warnings with the listed confidence levels. Leave empty to show
-# all. Valid levels: HIGH, INFERENCE, INFERENCE_FAILURE, UNDEFINED
-confidence=
-
-# Enable the message, report, category or checker with the given id(s). You can
-# either give multiple identifier separated by comma (,) or put this option
-# multiple time. See also the "--disable" option for examples.
-#enable=
-
-# Disable the message, report, category or checker with the given id(s). You
-# can either give multiple identifiers separated by comma (,) or put this
-# option multiple times (only on the command line, not in the configuration
-# file where it should appear only once).You can also use "--disable=all" to
-# disable everything first and then reenable specific checks. For example, if
-# you want to run only the similarities checker, you can use "--disable=all
-# --enable=similarities". If you want to run only the classes checker, but have
-# no Warning level messages displayed, use"--disable=all --enable=classes
-# --disable=W"
-# disable=import-star-module-level,old-octal-literal,oct-method,print-statement,unpacking-in-except,parameter-unpacking,backtick,old-raise-syntax,old-ne-operator,long-suffix,dict-view-method,dict-iter-method,metaclass-assignment,next-method-called,raising-string,indexing-exception,raw_input-builtin,long-builtin,file-builtin,execfile-builtin,coerce-builtin,cmp-builtin,buffer-builtin,basestring-builtin,apply-builtin,filter-builtin-not-iterating,using-cmp-argument,useless-suppression,range-builtin-not-iterating,suppressed-message,no-absolute-import,old-division,cmp-method,reload-builtin,zip-builtin-not-iterating,intern-builtin,unichr-builtin,reduce-builtin,standarderror-builtin,unicode-builtin,xrange-builtin,coerce-method,delslice-method,getslice-method,setslice-method,input-builtin,round-builtin,hex-method,nonzero-method,map-builtin-not-iterating
-
-disable=locally-disabled,missing-docstring,invalid-name,too-few-public-methods,redefined-variable-type,import-error,similarities,unsupported-membership-test,unsubscriptable-object,ungrouped-imports
+    ; PY2 Compat
+    super-with-arguments,
+    raise-missing-from

.readthedocs.yml

@@ -0,0 +1,12 @@
+# See https://docs.readthedocs.io/en/stable/config-file/index.html
+
+version: 2
+
+sphinx:
+  configuration: docs/conf.py
+
+formats:
+  - pdf
+
+submodules:
+  include: all

.travis.yml

@@ -1,23 +0,0 @@
-language: python
-python:
-  - "2.7"
-
-env:
-  - TOX_ENV=docs
-  - TOX_ENV=lint
-  - TOX_ENV=py26
-  - TOX_ENV=py27
-
-install:
-  - git submodule update --init --recursive
-  - pip install -U pip setuptools tox
-  - sudo apt-get install -qq lib32z1 lib32ncurses5 lib32bz2-1.0 # temporarily
-
-script:
-  - tox -e $TOX_ENV
-
-notifications:
-  slack:
-    secure: ksQmXOP5NVsf8IgoDuxD68Q/YNwDpZuwq0V29h2dxYCr38oYdAkq/Os4LSCs0X6P0cQFf6nC1hM/d+cAvU+SmzcHGxEceHNEGCg3/TAj+68KIwooPU93Lfq1zwdfteZWxANjKlCQy4+wZliHLhL8fvCYgfJww/6qKmqSYleBNM=
-    on_failure: always
-    on_success: change

CONTRIBUTING.md

@@ -0,0 +1,21 @@
+Contributing
+------------
+
+To get started, <a href="https://cla-assistant.io/platformio/platformio-core">sign the Contributor License Agreement</a>.
+
+1. Fork the repository on GitHub.
+2. Clone repository `git clone --recursive https://github.com/YourGithubUsername/platformio-core.git`
+3. Run `pip install tox`
+4. Go to the root of project where is located `tox.ini` and run `tox -e py37`
+5. Activate current development environment:
+
+   * Windows: `.tox\py37\Scripts\activate`
+   * Bash/ZSH: `source .tox/py37/bin/activate`
+   * Fish: `source .tox/py37/bin/activate.fish`
+
+6. Make changes to code, documentation, etc.
+7. Lint source code `make before-commit`
+8. Run the tests `make test`
+9. Build documentation `tox -e docs` (creates a directory _build under docs where you can find the html)
+10. Commit changes to your forked repository
+11. Submit a Pull Request on GitHub.

MANIFEST.in

@@ -0,0 +1 @@
+include LICENSE

Makefile

@@ -0,0 +1,38 @@
+lint:
+	pylint -j 6 --rcfile=./.pylintrc ./platformio
+	pylint -j 6 --rcfile=./.pylintrc ./tests
+
+isort:
+	isort -rc ./platformio
+	isort -rc ./tests
+
+format:
+	black --target-version py27 ./platformio
+	black --target-version py27 ./tests
+
+test:
+	py.test --verbose --capture=no --exitfirst -n 6 --dist=loadscope tests --ignore tests/test_examples.py
+
+before-commit: isort format lint
+
+clean-docs:
+	rm -rf docs/_build
+
+clean: clean-docs
+	find . -name \*.pyc -delete
+	find . -name __pycache__ -delete
+	rm -rf .cache
+	rm -rf build
+	rm -rf htmlcov
+	rm -f .coverage
+
+profile:
+	# Usage $ > make PIOARGS="boards" profile
+	python -m cProfile -o .tox/.tmp/cprofile.prof -m platformio ${PIOARGS}
+	snakeviz .tox/.tmp/cprofile.prof
+
+pack:
+	python setup.py sdist
+
+publish:
+	python setup.py sdist upload

README.rst

@@ -1,210 +1,153 @@
 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/dku0h2rutfj0ctls/branch/develop?svg=true
-    :target: https://ci.appveyor.com/project/ivankravets/platformio
-    :alt: AppVeyor.CI Build Status
-.. image:: https://requires.io/github/platformio/platformio/requirements.svg?branch=develop
-    :target: https://requires.io/github/platformio/platformio/requirements/?branch=develop
-    :alt: Requirements Status
+.. image:: https://github.com/platformio/platformio-core/workflows/Core/badge.svg
+    :target: https://docs.platformio.org/page/core/index.html
+    :alt:  CI Build for PlatformIO Core
+.. image:: https://github.com/platformio/platformio-core/workflows/Examples/badge.svg
+    :target: https://github.com/platformio/platformio-examples
+    :alt:  CI Build for dev-platform examples
+.. image:: https://github.com/platformio/platformio-core/workflows/Docs/badge.svg
+    :target: https://docs.platformio.org?utm_source=github&utm_medium=core
+    :alt:  CI Build for Docs
 .. image:: https://img.shields.io/pypi/v/platformio.svg
     :target: https://pypi.python.org/pypi/platformio/
     :alt: Latest Version
-.. image:: https://img.shields.io/pypi/l/platformio.svg
+.. image:: https://img.shields.io/badge/license-Apache%202.0-blue.svg
     :target: https://pypi.python.org/pypi/platformio/
     :alt:  License
-.. image:: https://img.shields.io/community/PlatformIO.png
-   :alt: Community Forums
-   :target: https://community.platformio.org
-.. image:: https://img.shields.io/donate/PlatformIO.png?color=yellow
-   :alt: Donate for PlatformIO.Org
-   :target: http://platformio.org/donate
+.. image:: https://img.shields.io/badge/PlatformIO-Labs-orange.svg
+   :alt: Community Labs
+   :target: https://piolabs.com/?utm_source=github&utm_medium=core
 
+**Quick Links:** `Web <https://platformio.org?utm_source=github&utm_medium=core>`_ |
+`PlatformIO IDE <https://platformio.org/platformio-ide?utm_source=github&utm_medium=core>`_ |
+`Project Examples <https://github.com/platformio/platformio-examples/>`__ |
+`Docs <https://docs.platformio.org?utm_source=github&utm_medium=core>`_ |
+`Donate <https://platformio.org/donate?utm_source=github&utm_medium=core>`_ |
+`Contact Us <https://piolabs.com/?utm_source=github&utm_medium=core>`_
 
-`Home <http://platformio.org>`_ |
-`IDE <http://platformio.org/platformio-ide>`_ |
-`Project Examples <https://github.com/platformio/platformio-examples/tree/develop>`_ |
-`Docs <http://docs.platformio.org>`_ |
+**Social:** `LinkedIn <https://www.linkedin.com/company/platformio/>`_ |
 `Twitter <https://twitter.com/PlatformIO_Org>`_ |
 `Facebook <https://www.facebook.com/platformio>`_ |
-`Hackaday <https://hackaday.io/project/7980-platformio>`_ |
-`Bintray <https://bintray.com/platformio>`_ |
-`Community <https://community.platformio.org>`_ |
-`Donate <http://platformio.org/donate>`_ |
-`Contact Us <http://platformio.org/contact>`_
+`Community Forums <https://community.platformio.org?utm_source=github&utm_medium=core>`_
 
-.. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-logo.png
-    :target: http://platformio.org
+.. image:: https://raw.githubusercontent.com/platformio/platformio-web/develop/app/images/platformio-ide-laptop.png
+    :target: https://platformio.org?utm_source=github&utm_medium=core
 
-`PlatformIO <http://platformio.org>`_ is an open source ecosystem for IoT
-development. Cross-platform build system and library manager. Continuous and
-IDE integration. Arduino and MBED compatible. Ready for Cloud compiling.
+`PlatformIO <https://platformio.org?utm_source=github&utm_medium=core>`_ is a professional collaborative platform for embedded development
 
-* **PlatformIO IDE** - The next-generation integrated development environment for IoT.
-  C/C++ Intelligent Code Completion and Smart Code Linter for the super-fast coding.
-  Multi-projects workflow with Multiple Panes. Themes Support with dark and light colors.
-  Built-in Terminal with PlatformIO CLI tool and support for the powerful Serial Port Monitor.
-  All advanced instruments without leaving your favourite development environment.
-* **Development Platforms** - Embedded and Desktop development platforms with
-  pre-built toolchains, debuggers, uploaders and frameworks which work under
-  popular host OS: Mac, Windows, Linux (+ARM)
-* **Embedded Boards** - Rapid Embedded Programming, IDE and Continuous
-  Integration in a few steps with PlatformIO thanks to built-in project
-  generator for the most popular embedded boards and IDE
-* **Library Manager** - Hundreds Popular Libraries are organized into single
-  Web 2.0 platform: list by categories, keywords, authors, compatible
-  platforms and frameworks; learn via examples; be up-to-date with the latest
-  version.
+**A place where Developers and Teams have true Freedom! No more vendor lock-in!**
 
-*Atmel AVR & SAM, Espressif, Freescale Kinetis, Intel ARC32, Lattice iCE40,
-Microchip PIC32, Nordic nRF51, NXP LPC, Silicon Labs EFM32, ST STM32,
-TI MSP430 & Tiva, Teensy, Arduino, mbed, libOpenCM3, etc.*
+* Open source, maximum permissive Apache 2.0 license
+* Cross-platform IDE and Unified Debugger
+* Static Code Analyzer and Remote Unit Testing
+* Multi-platform and Multi-architecture Build System
+* Firmware File Explorer and Memory Inspection.
 
-.. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-demo-wiring.gif
-    :target: http://platformio.org
+Get Started
+-----------
 
-* `PlatformIO IDE <http://platformio.org/platformio-ide>`_
-* `Get Started <http://platformio.org/get-started>`_
-* `Web 2.0 Library Search <http://platformio.org/lib>`_
-* `Development Platforms <http://platformio.org/platforms>`_
-* `Frameworks <http://platformio.org/frameworks>`_
-* `Embedded Boards Explorer <http://platformio.org/boards>`_
-* `Library Manager <http://docs.platformio.org/en/latest/librarymanager/index.html>`_
-* `User Guide <http://docs.platformio.org/en/latest/userguide/index.html>`_
-* `Continuous Integration <http://docs.platformio.org/en/latest/ci/index.html>`_
-* `IDE Integration <http://docs.platformio.org/en/latest/ide.html>`_
-* `Articles about us <http://docs.platformio.org/en/latest/articles.html>`_
-* `FAQ <http://docs.platformio.org/en/latest/faq.html>`_
-* `Release Notes <http://docs.platformio.org/en/latest/history.html>`_
+* `What is PlatformIO? <https://docs.platformio.org/page/what-is-platformio.html?utm_source=github&utm_medium=core>`_
+* `PlatformIO IDE <https://platformio.org/platformio-ide?utm_source=github&utm_medium=core>`_
+* `PlatformIO Core (CLI) <https://docs.platformio.org/page/core.html?utm_source=github&utm_medium=core>`_
+* `Project Examples <https://github.com/platformio/platformio-examples?utm_source=github&utm_medium=core>`__
 
-Use whenever. *Run everywhere.*
--------------------------------
-*PlatformIO* is written in pure *Python* and **doesn't depend** on any
-additional libraries/tools from an operating system. It allows you to use
-*PlatformIO* beginning from *PC (Mac, Linux, Win)* and ending with credit-card
-sized computers (`Raspberry Pi <http://www.raspberrypi.org>`_,
-`BeagleBone <http://beagleboard.org>`_,
-`CubieBoard <http://cubieboard.org>`_).
+Solutions
+---------
 
-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>`_.
+* `Library Management <https://docs.platformio.org/page/librarymanager/index.html?utm_source=github&utm_medium=core>`_
+* `Desktop IDEs Integration <https://docs.platformio.org/page/ide.html?utm_source=github&utm_medium=core>`_
+* `Continuous Integration <https://docs.platformio.org/page/ci/index.html?utm_source=github&utm_medium=core>`_
 
-* Colourful `command-line output <https://raw.githubusercontent.com/platformio/platformio/develop/examples/platformio-examples.png>`_
-* `IDE Integration <http://docs.platformio.org/en/latest/ide.html>`_ with
-  *Arduino, Atom, Eclipse, Emacs, Energia, Qt Creator, Sublime Text, Vim, Visual Studio*
-* Cloud compiling and `Continuous Integration <http://docs.platformio.org/en/latest/ci/index.html>`_
-  with *AppVeyor, Circle CI, Drone, Shippable, Travis CI*
-* Built-in `Serial Port Monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ and configurable
-  `build -flags/-options <http://docs.platformio.org/en/latest/projectconf.html#build-flags>`_
-* Automatic **firmware uploading**
-* Pre-built tool chains, frameworks for the popular `Hardware Platforms <http://platformio.org/platforms>`_
+**Advanced**
 
-.. image:: https://raw.githubusercontent.com/platformio/platformio-web/develop/app/images/platformio-embedded-development.png
-    :target: http://platformio.org
-    :alt:  PlatformIO Embedded Development Process
+* `Debugging <https://docs.platformio.org/page/plus/debugging.html?utm_source=github&utm_medium=core>`_
+* `Unit Testing <https://docs.platformio.org/page/plus/unit-testing.html?utm_source=github&utm_medium=core>`_
+* `Static Code Analysis <https://docs.platformio.org/page/plus/pio-check.html?utm_source=github&utm_medium=core>`_
+* `Remote Development <https://docs.platformio.org/page/plus/pio-remote.html?utm_source=github&utm_medium=core>`_
 
-The Missing Library Manager. *It's here!*
------------------------------------------
-*PlatformIO Library Manager* is the missing library manager for development
-platforms which allows you to organize and have up-to-date external libraries.
+Registry
+--------
 
-* 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/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
+* `Libraries <https://platformio.org/lib?utm_source=github&utm_medium=core>`_
+* `Development Platforms <https://platformio.org/platforms?utm_source=github&utm_medium=core>`_
+* `Frameworks <https://platformio.org/frameworks?utm_source=github&utm_medium=core>`_
+* `Embedded Boards <https://platformio.org/boards?utm_source=github&utm_medium=core>`_
 
-.. image:: https://raw.githubusercontent.com/platformio/platformio-web/develop/app/images/platformio-library-manager.png
-    :target: http://platformio.org
-    :alt:  PlatformIO Library Manager Architecture
+Development Platforms
+---------------------
 
-Smart Build System. *Fast and Reliable.*
-----------------------------------------
-*PlatformIO Code Builder* is built-on a next-generation software construction
-tool named `SCons <http://www.scons.org/>`_. Think of *SCons* as an improved,
-cross-platform substitute for the classic *Make* utility.
+* `Aceinna IMU <https://platformio.org/platforms/aceinna_imu?utm_source=github&utm_medium=core>`_
+* `ASR Microelectronics ASR605x <https://platformio.org/platforms/asrmicro650x?utm_source=github&utm_medium=core>`_
+* `Atmel AVR <https://platformio.org/platforms/atmelavr?utm_source=github&utm_medium=core>`_
+* `Atmel SAM <https://platformio.org/platforms/atmelsam?utm_source=github&utm_medium=core>`_
+* `Espressif 32 <https://platformio.org/platforms/espressif32?utm_source=github&utm_medium=core>`_
+* `Espressif 8266 <https://platformio.org/platforms/espressif8266?utm_source=github&utm_medium=core>`_
+* `Freescale Kinetis <https://platformio.org/platforms/freescalekinetis?utm_source=github&utm_medium=core>`_
+* `Infineon XMC <https://platformio.org/platforms/infineonxmc?utm_source=github&utm_medium=core>`_
+* `Intel ARC32 <https://platformio.org/platforms/intel_arc32?utm_source=github&utm_medium=core>`_
+* `Intel MCS-51 (8051) <https://platformio.org/platforms/intel_mcs51?utm_source=github&utm_medium=core>`_
+* `Kendryte K210 <https://platformio.org/platforms/kendryte210?utm_source=github&utm_medium=core>`_
+* `Lattice iCE40 <https://platformio.org/platforms/lattice_ice40?utm_source=github&utm_medium=core>`_
+* `Maxim 32 <https://platformio.org/platforms/maxim32?utm_source=github&utm_medium=core>`_
+* `Microchip PIC32 <https://platformio.org/platforms/microchippic32?utm_source=github&utm_medium=core>`_
+* `Nordic nRF51 <https://platformio.org/platforms/nordicnrf51?utm_source=github&utm_medium=core>`_
+* `Nordic nRF52 <https://platformio.org/platforms/nordicnrf52?utm_source=github&utm_medium=core>`_
+* `Nuclei <https://platformio.org/platforms/nuclei?utm_source=github&utm_medium=core>`_
+* `NXP LPC <https://platformio.org/platforms/nxplpc?utm_source=github&utm_medium=core>`_
+* `RISC-V <https://platformio.org/platforms/riscv?utm_source=github&utm_medium=core>`_
+* `RISC-V GAP <https://platformio.org/platforms/riscv_gap?utm_source=github&utm_medium=core>`_
+* `Shakti <https://platformio.org/platforms/shakti?utm_source=github&utm_medium=core>`_
+* `Silicon Labs EFM32 <https://platformio.org/platforms/siliconlabsefm32?utm_source=github&utm_medium=core>`_
+* `ST STM32 <https://platformio.org/platforms/ststm32?utm_source=github&utm_medium=core>`_
+* `ST STM8 <https://platformio.org/platforms/ststm8?utm_source=github&utm_medium=core>`_
+* `Teensy <https://platformio.org/platforms/teensy?utm_source=github&utm_medium=core>`_
+* `TI MSP430 <https://platformio.org/platforms/timsp430?utm_source=github&utm_medium=core>`_
+* `TI Tiva <https://platformio.org/platforms/titiva?utm_source=github&utm_medium=core>`_
+* `WIZNet W7500 <https://platformio.org/platforms/wiznet7500?utm_source=github&utm_medium=core>`_
 
-* Reliable, automatic *dependency analysis*
-* Reliable detection of *build changes*
-* Improved support for *parallel builds*
-* Ability to share *built files in a cache*
-* Lookup for external libraries which are installed via `Library Manager <http://docs.platformio.org/en/latest/librarymanager/index.html>`_
+Frameworks
+----------
 
-.. image:: https://raw.githubusercontent.com/platformio/platformio-web/develop/app/images/platformio-scons-builder.png
-    :target: http://platformio.org
-    :alt:  PlatformIO Build System Architecture
-
-Single source code. *Multiple platforms.*
------------------------------------------
-*PlatformIO* allows the developer to compile the same code with different
-development platforms using only *One Command*
-`platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`_.
-This happens due to
-`Project Configuration File (platformio.ini) <http://docs.platformio.org/en/latest/projectconf.html>`_
-where you can setup different environments with specific options (platform
-type, firmware uploading settings, pre-built framework, build flags and many
-more).
-
-It has support for 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>`_
-* `Intel ARC32 <http://platformio.org/platforms/intel_arc32>`_
-* `Lattice iCE40 <http://platformio.org/platforms/lattice_ice40>`_
-* `Microchip PIC32 <http://platformio.org/platforms/microchippic32>`_
-* `Nordic nRF51 <http://platformio.org/platforms/nordicnrf51>`_
-* `NXP LPC <http://platformio.org/platforms/nxplpc>`_
-* `ST STM32 <http://platformio.org/platforms/ststm32>`_
-* `Silicon Labs EFM32 <http://platformio.org/platforms/siliconlabsefm32>`_
-* `Teensy <http://platformio.org/platforms/teensy>`_
-* `TI MSP430 <http://platformio.org/platforms/timsp430>`_
-* `TI TIVA C <http://platformio.org/platforms/titiva>`_
-
-Frameworks:
-
-* `Arduino <http://platformio.org/frameworks/arduino>`_
-* `CMSIS <http://platformio.org/frameworks/cmsis>`_
-* `Energia <http://platformio.org/frameworks/energia>`_
-* `libOpenCM3 <http://platformio.org/frameworks/libopencm3>`_
-* `mbed <http://platformio.org/frameworks/mbed>`_
-* `Simba <http://platformio.org/frameworks/simba>`_
-* `SPL <http://platformio.org/frameworks/spl>`_
-* `WiringPi <http://platformio.org/frameworks/wiringpi>`_
-
-For further details, please refer to `What is PlatformIO? <http://docs.platformio.org/en/latest/faq.html#what-is-platformio>`_
+* `Arduino <https://platformio.org/frameworks/arduino?utm_source=github&utm_medium=core>`_
+* `CMSIS <https://platformio.org/frameworks/cmsis?utm_source=github&utm_medium=core>`_
+* `ESP-IDF <https://platformio.org/frameworks/espidf?utm_source=github&utm_medium=core>`_
+* `ESP8266 Non-OS SDK <https://platformio.org/frameworks/esp8266-nonos-sdk?utm_source=github&utm_medium=core>`_
+* `ESP8266 RTOS SDK <https://platformio.org/frameworks/esp8266-rtos-sdk?utm_source=github&utm_medium=core>`_
+* `Freedom E SDK <https://platformio.org/frameworks/freedom-e-sdk?utm_source=github&utm_medium=core>`_
+* `GigaDevice GD32V SDK <https://platformio.org/frameworks/gd32vf103-sdk?utm_source=github&utm_medium=core>`_
+* `Kendryte Standalone SDK <https://platformio.org/frameworks/kendryte-standalone-sdk?utm_source=github&utm_medium=core>`_
+* `Kendryte FreeRTOS SDK <https://platformio.org/frameworks/kendryte-freertos-sdk?utm_source=github&utm_medium=core>`_
+* `libOpenCM3 <https://platformio.org/frameworks/libopencm3?utm_source=github&utm_medium=core>`_
+* `Mbed <https://platformio.org/frameworks/mbed?utm_source=github&utm_medium=core>`_
+* `Nuclei SDK <https://platformio.org/frameworks/nuclei-sdk?utm_source=github&utm_medium=core>`_
+* `PULP OS <https://platformio.org/frameworks/pulp-os?utm_source=github&utm_medium=core>`_
+* `Pumbaa <https://platformio.org/frameworks/pumbaa?utm_source=github&utm_medium=core>`_
+* `Shakti SDK <https://platformio.org/frameworks/shakti-sdk?utm_source=github&utm_medium=core>`_
+* `Simba <https://platformio.org/frameworks/simba?utm_source=github&utm_medium=core>`_
+* `SPL <https://platformio.org/frameworks/spl?utm_source=github&utm_medium=core>`_
+* `STM32Cube <https://platformio.org/frameworks/stm32cube?utm_source=github&utm_medium=core>`_
+* `WiringPi <https://platformio.org/frameworks/wiringpi?utm_source=github&utm_medium=core>`_
+* `Zephyr <https://platformio.org/frameworks/zephyr?utm_source=github&utm_medium=core>`_
 
 Contributing
 ------------
 
-1. Fork the repository on GitHub.
-2. Make a branch off of ``develop``
-3. Run ``pip install tox``
-4. Go to the root of project where is located ``tox.ini`` and run ``tox -e develop``
-5. Activate current development environment:
+See `contributing guidelines <https://github.com/platformio/platformio/blob/develop/CONTRIBUTING.md>`_.
 
-   * Windows: ``.tox\develop\Scripts\activate``
-   * Bash/ZSH: ``source .tox/develop/bin/activate``
-   * Fish: ``source .tox/bin/activate.fish``
+Telemetry / Privacy Policy
+--------------------------
 
-6. Make changes to code, documentation, etc.
-7. Lint source code ``tox -e lint``
-8. Run the tests ``tox -e py27``
-9. Commit changes to your forked repository
-10. Submit a Pull Request on GitHub.
+Share minimal diagnostics and usage information to help us make PlatformIO better.
+It is enabled by default. For more information see:
 
-Licence
+* `Telemetry Setting <https://docs.platformio.org/page/userguide/cmd_settings.html?utm_source=github&utm_medium=core#enable-telemetry>`_
+
+License
 -------
 
-Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
+Copyright (c) 2014-present PlatformIO <contact@platformio.org>
 
-The PlatformIO is licensed under the permissive Apache 2.0 licence,
+The PlatformIO is licensed under the permissive Apache 2.0 license,
 so you can use it in both commercial and personal projects with confidence.

appveyor.yml

@@ -1,13 +0,0 @@
-build: off
-environment:
-
-  matrix:
-    - TOXENV: "py27"
-
-install:
-  - cmd: git submodule update --init --recursive
-  - cmd: SET PATH=%PATH%;C:\Python27\Scripts;C:\MinGW\bin
-  - cmd: pip install tox
-
-test_script:
-  - cmd: tox

docs/Makefile

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

docs/_static/extra.css

@@ -1,314 +0,0 @@
-/**
- * Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-header,
-nav {
-  display: block;
-}
-
-#pionav {
-  display: none;
-}
-
-.container {
-  padding-right: 15px;
-  padding-left: 15px;
-  margin-right: auto;
-  margin-left: auto;
-}
-
-@media (min-width: 992px) {
-  #pionav {
-    display: block !important;
-  }
-  body {
-    padding-top: 50px;
-  }
-  .wy-nav-side {
-    top: 50px;
-  }
-
-  .container {
-    width: 970px;
-  }
-}
-@media (min-width: 1200px) {
-  .container {
-    width: 1150px;
-  }
-}
-.container-fluid {
-  padding-right: 15px;
-  padding-left: 15px;
-  margin-right: auto;
-  margin-left: auto;
-}
-
-.container:before,
-.container:after,
-.container-fluid:before,
-.container-fluid:after,
-.nav:before,
-.nav:after,
-.navbar:before,
-.navbar:after,
-.navbar-header:before,
-.navbar-header:after {
-  display: table;
-  content: " ";
-}
-.container:after,
-.container-fluid:after,
-.nav:after,
-.navbar:after,
-.navbar-header:after {
-  clear: both;
-}
-
-.nav {
-  padding-left: 0;
-  margin-bottom: 0;
-  list-style: none;
-}
-.nav > li {
-  position: relative;
-  display: block;
-}
-.nav > li > a {
-  position: relative;
-  display: block;
-  padding: 10px 15px;
-  font-size: 14px;
-}
-.nav > li > a:hover,
-.nav > li > a:focus {
-  text-decoration: none;
-  background-color: #eee;
-}
-.nav > li > a > img {
-  max-width: none;
-}
-.nav > li > a > i {
-  margin-right: 5px;
-}
-
-.navbar {
-  position: relative;
-  min-height: 50px;
-  margin-bottom: 20px;
-  border: 1px solid transparent;
-}
-@media (min-width: 768px) {
-  .navbar {
-    border-radius: 4px;
-  }
-}
-@media (min-width: 768px) {
-  .navbar-header {
-    float: left;
-  }
-}
-
-@media (min-width: 768px) {
-  .navbar-fixed-top {
-    padding-right: 0;
-    padding-left: 0;
-  }
-}
-.navbar-fixed-top {
-  max-height: 340px;
-}
-.container > .navbar-header,
-.container-fluid > .navbar-header {
-  margin-right: -15px;
-  margin-left: -15px;
-}
-@media (min-width: 768px) {
-  .container > .navbar-header,
-  .container-fluid > .navbar-header {
-    margin-right: 0;
-    margin-left: 0;
-  }
-}
-
-.navbar-fixed-top {
-  position: fixed;
-  right: 0;
-  left: 0;
-  z-index: 1030;
-}
-@media (min-width: 768px) {
-  .navbar-fixed-top {
-    border-radius: 0;
-  }
-}
-.navbar-fixed-top {
-  top: 0;
-  border-width: 0 0 1px;
-}
-.navbar-fixed-bottom {
-  bottom: 0;
-  margin-bottom: 0;
-  border-width: 1px 0 0;
-}
-.navbar-brand {
-  float: left;
-  height: 50px;
-  padding: 15px 15px;
-  font-size: 18px;
-  line-height: 20px;
-}
-.navbar-brand:hover,
-.navbar-brand:focus {
-  text-decoration: none;
-}
-.navbar-brand > img {
-  display: block;
-}
-@media (min-width: 768px) {
-  .navbar > .container .navbar-brand,
-  .navbar > .container-fluid .navbar-brand {
-    margin-left: -15px;
-  }
-}
-
-.navbar-nav {
-  margin: 7.5px -15px;
-}
-.navbar-nav > li > a {
-  padding-top: 10px;
-  padding-bottom: 10px;
-  line-height: 20px;
-}
-@media (min-width: 768px) {
-  .navbar-nav {
-    float: left;
-    margin: 0;
-  }
-  .navbar-nav > li {
-    float: left;
-  }
-  .navbar-nav > li > a {
-    padding-top: 15px;
-    padding-bottom: 15px;
-  }
-}
-
-@media (min-width: 768px) {
-  .navbar-left {
-    float: left !important;
-  }
-  .navbar-right {
-    float: right !important;
-    margin-right: -15px;
-  }
-  .navbar-right ~ .navbar-right {
-    margin-right: 0;
-  }
-}
-
-.navbar-inverse {
-  background-color: #222;
-  border-color: #080808;
-}
-.navbar-inverse .navbar-brand {
-  color: #9d9d9d;
-}
-.navbar-inverse .navbar-brand:hover,
-.navbar-inverse .navbar-brand:focus {
-  color: #fff;
-  background-color: transparent;
-}
-.navbar-inverse .navbar-text {
-  color: #9d9d9d;
-}
-.navbar-inverse .navbar-nav > li > a {
-  color: #9d9d9d;
-}
-.navbar-inverse .navbar-nav > li > a:hover,
-.navbar-inverse .navbar-nav > li > a:focus {
-  color: #fff;
-  background-color: transparent;
-}
-.navbar-inverse .navbar-nav > .active > a,
-.navbar-inverse .navbar-nav > .active > a:hover,
-.navbar-inverse .navbar-nav > .active > a:focus {
-  color: #fff;
-  background-color: #080808;
-}
-
-.navbar-header .navbar-brand {
-  color: #e0e0e0;
-}
-
-/* Misc */
-
-.wy-side-scroll .wy-side-nav-search .icon,
-.wy-side-scroll .wy-side-nav-search .version {
-  display: none;
-  visibility: none;
-}
-
-.navbar-header .navbar-brand {
-  color: #e0e0e0;
-  background: url("../_static/platformio-logo-xs.png") no-repeat;
-  background-position: 5px 0;
-  padding-left: 50px;
-  font-weight: 500;
-}
-
-.navbar .github-corner {
-  display: none;
-}
-
-.navbar .github-corner svg {
-  fill: #fff;
-  color: #080808;
-  position: absolute;
-  top: -1px;
-  right: 0;
-  border: 0;
-  width: 50px;
-  height: 50px;
-  transform: scale(1, 1);
-}
-
-@media screen and (min-width: 992px) {
-  .navbar .github-corner {
-    display: block;
-  }
-}
-
-.top-banner {
-  display: block;
-  padding: 10px 20px;
-  font-weight: bold;
-  font-size: 14px;
-  color: #fff;
-  text-align: center;
-  background-color: #0275d8;
-}
-
-.top-banner:hover {
-  color: #fff;
-  text-decoration: none;
-  background-color: #025ebb;
-}
-
-.top-banner:visited {
-  color: #fff;
-  text-decoration: none;
-}

docs/_templates/footer.html

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

docs/articles.rst

@@ -1,102 +0,0 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _articles:
-
-Articles about us
-=================
-
-.. note::
-    If you've written article about PlatformIO and would like it listed on
-    this page, `please edit this page <https://github.com/platformio/platformio/blob/develop/docs/articles.rst>`_.
-
-Here are recent articles about PlatformIO:
-
-2016
-^^^^
-
-* May 30, 2016 - **Ron Moerman** - `IoT Development with PlatformIO <https://electronicsworkbench.io/blog/platformio>`_
-* May 29, 2016 - **Chris Synan** - `Reverse Engineer RF Remote Controller for IoT! <http://www.instructables.com/id/Reverse-Engineer-RF-Remote-Controller-for-IoT/?ALLSTEPS>`_
-* May 26, 2016 - **Charlie Key** - `7 Best Developer Tools To Build Your NEXT Internet of Things Application <https://www.losant.com/blog/7-best-developer-tools-to-build-your-next-internet-of-things-application>`_
-* May 22, 2016 - **Pedro Minatel** - `Estação meteorológica com ESP8266 (Weather station with ESP8266, Portuguese) <http://pedrominatel.com.br/esp8266/estacao-meteorologica-com-esp8266/>`_
-* May 16, 2016 - **Pedro Minatel** - `Controle remoto WiFi com ESP8266 (WiFi remote control using ESP8266, Portuguese) <http://pedrominatel.com.br/esp8266/controle-remoto-wifi-com-esp8266/>`_
-* May 11, 2016 - **Jo Vandeginste** - `Using PlatformIO to compile for Jeelabs' Jeenode Micro <http://jovandeginste.github.io/2016/05/11/using-platformio-to-compile-for-jeelabs-jeenode-micro.html>`_
-* May 08, 2016 - **Radoslaw Bob** - `Touch controlled buzzer (Nodemcu ESP8266) <https://gettoknowthebob.wordpress.com/2016/05/08/touch-controlled-buzzer-nodemcu-esp8266/>`_
-* May 06, 2016 - **Jean Roux** - `The IoT building blocks I use for my home-automation projects <http://iotplay.blogspot.fr/2016/05/the-components-i-use-for-my-projects.html/>`_
-* May 05, 2016 - **Ivan Kravets, Ph.D. / Eclipse Virtual IoT Meetup** - `PlatformIO: a cross-platform IoT solution to build them all! <http://www.meetup.com/Virtual-IoT/events/229964142/>`_
-* May 01, 2016 - **Pedro Minatel** - `PlatformIO – Uma alternativa ao Arduino IDE (PlatformIO - An alternative to the Arduino IDE, Portuguese) <http://pedrominatel.com.br/ferramentas/platformio-uma-alternativa-ao-arduino-ide/>`_
-* Apr 23, 2016 - **Al Williams** - `Hackaday: Atomic Arduino (and Other) Development <http://hackaday.com/2016/04/23/atomic-arduino-and-other-development/>`_
-* Apr 16, 2016 - **Sathittham Sangthong** - `[PlatformIO] มาลองเล่น PlatformIO แทน Arduino IDE กัน (Let's play together with PlatformIO IDE [alternative to Arduino IDE], Thai) <http://www.sathittham.com/platformio/platformio-ide/>`_
-* Apr 15, 2016 - **Daniel Eichhorn** - `ESP8266: Offline Debugging with the Platformio Environment <http://blog.squix.ch/2016/04/esp8266-offline-debugging-with.html>`_
-* Apr 11, 2016 - **Matjaz Trcek** - `Top 5 Arduino integrated development environments <https://codeandunicorns.com/top-5-arduino-integrated-development-environments-ide/>`_
-* Apr 06, 2016 - **Aleks** - `PlatformIO ausprobiert (Tried PlatformIO, German) <http://5volt-junkie.net/platformio/>`_
-* Apr 02, 2016 - **Diego Pinto** - `Você tem coragem de abandonar a IDE do Arduino? PlatformIO + Atom (Do you dare to leave the Arduino IDE? PlatformIO + Atom, Portuguese) <http://www.clubemaker.com.br/?rota=artigo/81>`_
-* Mar 30, 2016 - **Brandon Cannaday** - `Getting Started with PlatformIO and ESP8266 NodeMcu <https://www.losant.com/blog/getting-started-with-platformio-esp8266-nodemcu>`_
-* Mar 29, 2016 - **Pablo Peñalve** - `PlatformIO + Geany + Raspberry PI, Spanish <http://ret-catriel.blogspot.com/2016/03/framework-platformio-geany-raspberry-pi.html>`_
-* Mar 24, 2016 - **NAzT** - `PlatformIO และการปรับแต่ง เพื่อใช้สำหรับพัฒนา Arduino Library (PlatformIO and advanced development for Arduino Library, Thai) <https://cmmakerclub.com/tools-2/config-platformio-for-arduino-framework-developer/>`_
-* Mar 16, 2016 - **Jakub Skořepa** - `Instalace PlatformIO (PlatformIO IDE Installation, Czech) <http://ok1kvk.cz/clanek/2016/instalace-platformio/>`_
-* Mar 12, 2016 - **Peter Marks** - `PlatformIO, the Arduino IDE for programmers <http://blog.marxy.org/2016/03/platformio-arduino-ide-for-programmers.html>`_
-* Mar 12, 2016 - **Richard Arthurs** - `Getting Started With PlatformIO <http://richarthurs.com/2016/03/12/platformio-review-and-first-thoughts/>`_
-* Mar 07, 2016 - **Joran Jessurun** - `Nieuwe wereld met PlatformIO (New world with PlatformIO, Dutch) <http://blog.wisclub.nl/#post178>`_
-* Mar 05, 2016 - **brichacek.net** - `PlatformIO – otevřený ekosystém pro vývoj IoT (PlatformIO – an open source ecosystem for IoT development, Czech) <http://blog.brichacek.net/platformio-otevreny-ekosystem-pro-vyvoj-iot/>`_
-* Mar 04, 2016 - **Ricardo Vega** - `Programa tu Arduino desde Atom (Program your Arduino from Atom, Spanish) <http://ricveal.com/blog/programa-arduino-desde-atom/>`_
-* Feb 28, 2016 - **Alex Bloggt** - `PlatformIO vorgestellt (Introduction to PlatformIO IDE, German) <https://alexbloggt.com/platformio-vorgestellt/>`_
-* Feb 25, 2016 - **NutDIY** - `PlatformIO Blink On Nodemcu Dev Kit V1.0 (Thai) <http://nutdiy.blogspot.com/2016/02/platformio-blink-on-nodemcu-dev-kit-v10.html>`_
-* Feb 23, 2016 - **Ptarmigan Labs** - `ESP8266 Over The Air updating – what are the options? <https://ptarmiganlabs.com/blog/2016/02/23/esp8266-over-the-air-updating-what-are-the-options/>`_
-* Feb 22, 2016 - **Grzegorz Hołdys** - `How to Integrate PlatformIO with Netbeans <http://www.instructables.com/id/How-to-Integrate-PlatformIO-With-Netbeans/>`_
-* Feb 19, 2016 - **Embedds** - `Develop easier with PlatformIO ecosystem <http://www.embedds.com/develop-easier-with-platformio-ecosystem/>`_
-* Feb 13, 2016 - **Robert Cudmore** - `Programming an arduino with PlatformIO <http://blog.cudmore.io/post/2016/02/13/Programming-an-arduino-with-platformio/>`_
-* Jan 24, 2016 - **Sergey Prilukin** - `How to use IntelliJ IDEA to develop and upload software for micro controllers like Arduino <http://jandevblog.blogspot.com/2016/01/how-to-use-intellij-idea-to-develop-and.html>`_
-* Jan 16, 2016 - **Dani Eichhorn** - `ESP8266 Arduino IDE Alternative: PlatformIO <http://blog.squix.ch/2016/01/esp8266-arduino-ide-alternative.html>`_
-* Jan 11, 2016 - **David Mills, Ph.D.** - `STM NUCLEOF401RE TIMER IO <http://webshed.org/wiki/STM_NUCLEOF401RE_TIMER_IO>`_
-* Jan 05, 2016 - **Julien Rodrigues** - `Internet Of Things: The IDE scandal <https://medium.com/@jrodrigues/internet-of-things-the-ide-scandal-5ddb8fc9d918>`_
-
-2015
-^^^^
-
-* Dec 22, 2015 - **Jan Penninkhof** - `Over-the-Air ESP8266 programming using PlatformIO <http://www.penninkhof.com/2015/12/1610-over-the-air-esp8266-programming-using-platformio/>`_
-* Dec 15, 2015 - **stastaka** - `PlatformIOでカスタムボードを使う (Use a custom board for PlatformIO, Japanese) <http://qiita.com/stastaka/items/a6a50dbbb2933bd78bdd>`_
-* Dec 08, 2015 - **Piotr Król** - `Using PlatformIO with TI MSP430 LunchPads <http://blog.3mdeb.com/2015/12/08/using-platformio-with-ti-msp430-lunchpads/>`_
-* Dec 01, 2015 - **Michał Seroczyński** - `Push Notification from Arduino Yún with motion sensor <http://www.ches.pl/push-from-yun-1/>`_
-* Dec 01, 2015 - **JetBrains CLion Blog** - `C++ Annotated: Fall 2015. Arduino Support in CLion using PlatformIO <http://blog.jetbrains.com/clion/2015/12/cpp-annotated-fall-2015/>`_
-* Dec 01, 2015 - **Tateno Yuichi** - `ESP8266 を CUI で開発する (Develop a ESP8266 in CUI, Japanese) <http://jaywiggins.com/platformio/arduino/avr/es8266/2015/09/30/platformio-investigation/>`_
-* Nov 29, 2015 - **Keith Hughes** - `Using PlatformIO for Embedded Projects <http://smartspacestuff.blogspot.com/2015/11/using-platformio-for-embedded-projects.html>`_
-* Nov 22, 2015 - **Michał Seroczyński** - `Using PlatformIO to get started with Arduino in CLion IDE <http://www.ches.pl/using-platformio-get-started-arduino-clion-ide/>`_
-* Nov 09, 2015 - **ÁLvaro García Gómez** - `Programar con Arduino "The good way" (Programming with Arduino "The good way", Spanish) <http://congdegnu.es/2015/11/09/programar-con-arduino-the-good-way/>`_
-* Nov 06, 2015 - **nocd5** - `PlatformIOでmbedをオフラインビルドしSTM32 Nucleoボードでmrubyを使う (Use mruby in the offline build for STM32 Nucleo board with mbed and PlatformIO, Japanese) <http://qiita.com/nocd5/items/d5fda776240f7e7c17eb>`_
-* Oct 21, 2015 - **Vittorio Zaccaria** - `Using a cheap STM32 Nucleo to teach remote sensor monitoring <http://www.vittoriozaccaria.net/blog/2015/10/21/using-a-cheap-stm32-nucleo-to-teach-remote-sensor-monitoring.html>`_
-* Oct 18, 2015 - **Nico Coetzee** - `First Arduino I2C Experience with PlatformIO <https://electronicventurer.wordpress.com/2015/10/18/first-arduino-i2c-experience/>`_
-* Oct 10, 2015 - **Floyd Hilton** - `Programming Arduino with Atom <http://floydhilton.com/software/career/2015/10/10/Arduino_with_Atom.html>`_
-* Oct 01, 2015 - **Mistan** - `Compile and Upload Arduino Sketch with PlatformIO for Raspberry Pi Running Arch Linux <http://tech.memoryimprintstudio.com/code-building-for-arduino-with-platformio-for-raspberry-pi-with-arch-linux/>`_
-* Sep 30, 2015 - **Jay Wiggins** - `PlatformIO Investigation <http://jaywiggins.com/platformio/arduino/avr/es8266/2015/09/30/platformio-investigation/>`_
-* Sep 01, 2015 - **Thomas P. Weldon, Ph.D.** - `Improvised MBED FRDM-K64F Eclipse/PlatformIO Setup and Software Installation <http://thomasweldon.com/tpw/courses/embeddsp/p00pcFrdmK64_eclipsePlatformioSetup.html>`_
-* Aug 08, 2015 - **Josh Glendenning** - `Armstrap Eagle and PlatformIO <http://isobit.io/2015/08/08/armstrap.html>`_
-* Aug 01, 2015 - **Russell Davis** - `PlatformIO on the Raspberry Pi <http://www.russelldavis.org/2015/08/01/platformio-on-the-raspberry-pi/>`_
-* Jul 25, 2015 - **DinoTools** - `Erste Schritte mit PlatformIO (Getting Started with PlatformIO, German) <https://www.dinotools.de/2015/07/25/erste-schritte-mit-platformio/>`_
-* Jul 20, 2015 - **Eli Fatsi** - `Arduino Development in Atom Editor <http://viget.com/extend/arduino-development-in-atom-editor>`_
-* Jul 14, 2015 - **ElbinarIO** - `Programar para Arduino y otros microcontroladores desde la linea de comandos (Program Arguino and other microcontrollers from the command line, Spanish) <http://elbinario.net/2015/07/14/programar-para-arduino-y-otros-microcontroladores-desde-la-linea-de-comandos/>`_
-* Jul 11, 2015 - **TrojanC** - `Learning Arduino GitHub Repository <http://www.trojanc.co.za/2015/07/11/learning-arduino-github-repository/>`_
-* Jul 07, 2015 - **Sho Hashimoto** - `PlatformIOでArduino開発する(Arduino development in PlatformIO, Japanese) <http://shokai.org/blog/archives/10250>`_
-* Jun 02, 2015 - **Alejandro Guirao Rodríguez** - `Discovering PlatformIO: The RaspberryPi / Arduino combo kit is a winner option when prototyping an IoT-style project <http://lekum.org/posts/discovering-platformio/index.html>`_
-* May 17, 2015 - **S.S** - `コマンドラインでArduino開発 : vim + platformio (Arduino development at the command line: VIM + PlatformIO, Japanese) <http://qiita.com/caad1229/items/7b5fb47f034ae6e0baf2>`_
-* May 11, 2015 - **IT Hare** - `From Web Developer to Embedded One: Interview with Ivan Kravets, The Guy Behind PlatformIO. Part II <http://ithare.com/from-web-developer-to-embedded-one-interview-with-ivan-kravets-the-guy-behind-platformio-part-ii/>`_
-* May 4, 2015 - **IT Hare** - `From Web Developer to Embedded One: Interview with Ivan Kravets, The Guy Behind PlatformIO. Part I <http://ithare.com/from-web-development-to-embedded-one-interview-with-ivan-kravets-the-guy-behind-platformio-part-i/>`_
-* Apr 17, 2015 - **Michael Ball** - `PlatformIO - A Cross-Platform Code Builder and Missing Library Manager <http://arduino-pi.blogspot.com.es/2015/04/platformio-cross-platform-code-builder.html>`_
-* Mar 23, 2015 - **Atmel** - `Cross-board and cross-vendor embedded development with PlatformIO <http://blog.atmel.com/2015/03/23/cross-board-and-cross-vendor-embedded-development-with-platformio/>`_
-* Mar 22, 2015 - **Mark VandeWettering** - `Discovered a new tool for embedded development: PlatformIO <http://brainwagon.org/2015/03/22/discovered-a-new-tool-for-embedded-development-platformio/>`_
-* Feb 25, 2015 - **Hendrik Putzek** - `Use your favourite IDE together with Arduino <http://blog.putzek.com/2015/02/your-favourite-ide-with-arduino.html>`_
-
-2014
-^^^^
-
-* Oct 7, 2014 - **Ivan Kravets, Ph.D.** - `Integration of PlatformIO library manager to Arduino and Energia IDEs <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_
-* Jun 20, 2014 - **Ivan Kravets, Ph.D.** - `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_
-* Jun 17, 2014 - **Ivan Kravets, Ph.D.** - `How was PlatformIO born or why I love Python World <http://www.ikravets.com/computer-life/programming/2014/06/17/how-was-platformio-born-or-why-i-love-python-world>`_

docs/ci/appveyor.rst

@@ -1,87 +0,0 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _ci_appveyor:
-
-AppVeyor
-========
-
-`AppVeyor <http://www.appveyor.com/about>`_ is an open-source hosted,
-distributed continuous integration service used to build and test projects
-hosted at `GitHub <http://en.wikipedia.org/wiki/GitHub>`_ on Windows family
-systems.
-
-AppVeyor is configured by adding a file named ``appveyor.yml``, which is a
-`YAML <http://en.wikipedia.org/wiki/YAML>`_ format text file, to the root
-directory of the GitHub repository.
-
-AppVeyor automatically detects when a commit has been made and pushed to a
-GitHub repository that is using AppVeyor, and each time this happens, it will
-try to build the project using :ref:`cmd_ci` command. This includes commits to
-all branches, not just to the master branch. AppVeyor will also build and run
-pull requests. When that process has completed, it will notify a developer in
-the way it has been configured to do so — for example, by sending an email
-containing the build results (showing success or failure), or by posting a
-message on an IRC channel. It can be configured to build project on a range of
-different :ref:`platforms`.
-
-.. contents::
-
-Integration
------------
-
-Put ``appveyor.yml`` to the root directory of the GitHub repository.
-
-.. code-block:: yaml
-
-    build: off
-    environment:
-
-      matrix:
-        - PLATFORMIO_CI_SRC: "path\\to\\source\\file.c"
-        - PLATFORMIO_CI_SRC: "path\\to\\source\\file.ino"
-        - PLATFORMIO_CI_SRC: "path\\to\\source\\directory"
-
-    install:
-        - cmd: git submodule update --init --recursive
-        - cmd: SET PATH=%PATH%;C:\Python27\Scripts
-        - cmd: pip install -U platformio
-
-    test_script:
-        - cmd: platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-
-For more details as for PlatformIO build process please look into :ref:`cmd_ci`
-command.
-
-Examples
---------
-
-1. Integration for `USB_Host_Shield_2.0 <https://github.com/felis/USB_Host_Shield_2.0>`_
-   project. The ``appveyor.yml`` configuration file:
-
-.. code-block:: yaml
-
-    build: off
-    environment:
-
-      matrix:
-        - PLATFORMIO_CI_SRC: "examples\\Bluetooth\\PS3SPP\\PS3SPP.ino"
-        - PLATFORMIO_CI_SRC: "examples\\pl2303\\pl2303_gps\\pl2303_gps.ino"
-
-    install:
-        - cmd: git submodule update --init --recursive
-        - cmd: SET PATH=%PATH%;C:\Python27\Scripts
-        - cmd: pip install -U platformio
-        - cmd: git clone https://github.com/xxxajk/spi4teensy3.git C:\spi4teensy
-
-    test_script:
-        - cmd: platformio ci --lib="." --lib="C:\\spi4teensy" --board=uno --board=teensy31 --board=due

docs/ci/circleci.rst

@@ -1,205 +0,0 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _ci_circleci:
-
-Circle CI
-=========
-
-`Circle CI <https://circleci.com/about>`_ is a hosted cloud
-platform that provides hosted continuous integration, deployment, and testing
-to `GitHub <http://en.wikipedia.org/wiki/GitHub>`_ repositories.
-
-Circle CI is configured by adding a file named ``circle.yml``, which is a
-`YAML <http://en.wikipedia.org/wiki/YAML>`_ format text file, to the root
-directory of the GitHub repository.
-
-Circle CI automatically detects when a commit has been made and pushed to a
-GitHub repository that is using Circle CI, and each time this happens, it will
-try to build the project using :ref:`cmd_ci` command. This includes commits to
-all branches, not just to the master branch. Circle CI will also build and run
-pull requests. When that process has completed, it will notify a developer in
-the way it has been configured to do so — for example, by sending an email
-containing the build results (showing success or failure), or by posting a
-message on an IRC channel. It can be configured to build project on a range of
-different :ref:`platforms`.
-
-.. contents::
-
-Integration
------------
-
-Please make sure to read Circle CI `Getting Started <https://circleci.com/docs/getting-started>`_
-guide first.
-
-.. code-block:: yaml
-
-    dependencies:
-        pre:
-            # Install the latest stable PlatformIO
-            - sudo pip install -U platformio
-
-    test:
-        override:
-            - platformio ci path/to/test/file.c --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-            - platformio ci examples/file.ino --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-            - platformio ci path/to/test/directory --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-
-For more details as for PlatformIO build process please look into :ref:`cmd_ci`.
-
-Project as a library
-~~~~~~~~~~~~~~~~~~~~
-
-When project is written as a library (where own examples or testing code use
-it), please use ``--lib="."`` option for :ref:`cmd_ci` command
-
-.. code-block:: yaml
-
-    script:
-        - platformio ci --lib="." --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-Library dependecies
-~~~~~~~~~~~~~~~~~~~
-
-There 2 options to test source code with dependent libraries:
-
-Install dependent library using :ref:`librarymanager`
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. code-block:: yaml
-
-    dependencies:
-        pre:
-            # Install the latest stable PlatformIO
-            - sudo pip install -U platformio
-
-            # OneWire Library with ID=1 http://platformio.org/lib/show/1/OneWire
-            - platformio lib install 1
-
-    test:
-        override:
-            - platformio ci path/to/test/file.c --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-Manually download dependent library and include in build process via ``--lib`` option
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. code-block:: yaml
-
-    dependencies:
-        pre:
-            # Install the latest stable PlatformIO
-            - sudo pip install -U platformio
-
-            # download library to the temporary directory
-            - wget https://github.com/PaulStoffregen/OneWire/archive/master.zip -O /tmp/onewire_source.zip
-            - unzip /tmp/onewire_source.zip -d /tmp/
-
-    test:
-        override:
-            - platformio ci path/to/test/file.c --lib="/tmp/OneWire-master" --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-Custom Build Flags
-~~~~~~~~~~~~~~~~~~
-
-PlatformIO allows to specify own build flags using :envvar:`PLATFORMIO_BUILD_FLAGS` environment
-
-.. code-block:: yaml
-
-    machine:
-        environment:
-            PLATFORMIO_BUILD_FLAGS: -D SPECIFIC_MACROS -I/extra/inc
-
-
-For the more details, please follow to
-:ref:`available build flags/options <projectconf_build_flags>`.
-
-
-Advanced configuration
-~~~~~~~~~~~~~~~~~~~~~~
-
-PlatformIO allows to configure multiple build environments for the single
-source code using :ref:`projectconf`.
-
-Instead of ``--board`` option, please use :option:`platformio ci --project-conf`
-
-.. code-block:: yaml
-
-    test:
-        override:
-            - platformio ci path/to/test/file.c --project-conf=/path/to/platoformio.ini
-
-Examples
---------
-
-1. Custom build flags
-
-.. code-block:: yaml
-
-    dependencies:
-        cache_directories:
-            - "~/.platformio"
-
-        pre:
-            - sudo pip install -U platformio
-
-            # pre-install PlatformIO development platforms, they will be cached
-            - platformio platforms install atmelavr atmelsam teensy
-
-            #
-            # Libraries from PlatformIO Library Registry:
-            #
-            # http://platformio.org/lib/show/416/TinyGPS
-            # http://platformio.org/lib/show/417/SPI4Teensy3
-            - platformio lib install 416 417
-
-    test:
-        override:
-            - platformio ci examples/acm/acm_terminal --board=uno --board=teensy31 --board=due --lib="."
-            - platformio ci examples/adk/adk_barcode --board=uno --board=teensy31 --board=due --lib="."
-            - platformio ci examples/adk/ArduinoBlinkLED --board=uno --board=teensy31 --board=due --lib="."
-            - platformio ci examples/adk/demokit_20 --board=uno --board=teensy31 --board=due --lib="."
-            # ...
-            - platformio ci examples/Xbox/XBOXUSB --board=uno --board=teensy31 --board=due --lib="."
-
-* Configuration file: https://github.com/ivankravets/USB_Host_Shield_2.0/blob/master/circle.yml
-* Build History: https://circleci.com/gh/ivankravets/USB_Host_Shield_2.0/tree/master
-
-2. Dependency on external libraries
-
-.. code-block:: yaml
-
-    dependencies:
-        pre:
-            # Install the latest stable PlatformIO
-            - sudo pip install -U platformio
-
-            # download dependent libraries
-            - wget https://github.com/jcw/jeelib/archive/master.zip -O /tmp/jeelib.zip
-            - unzip /tmp/jeelib.zip -d /tmp
-
-            - wget https://github.com/Rodot/Gamebuino/archive/master.zip  -O /tmp/gamebuino.zip
-            - unzip /tmp/gamebuino.zip -d /tmp
-
-    test:
-        override:
-            -  platformio ci examples/backSoon/backSoon.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
-            -  platformio ci examples/etherNode/etherNode.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
-            -  platformio ci examples/getDHCPandDNS/getDHCPandDNS.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
-            -  platformio ci examples/getStaticIP/getStaticIP.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
-            # ...
-            -  platformio ci examples/twitter/twitter.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
-            -  platformio ci examples/udpClientSendOnly/udpClientSendOnly.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
-            -  platformio ci examples/udpListener/udpListener.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
-            -  platformio ci examples/webClient/webClient.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
-
-* Configuration file: hhttps://github.com/ivankravets/ethercard/blob/master/circle.yaml
-* Build History: https://circleci.com/gh/ivankravets/ethercard/tree/master

docs/ci/drone.rst

@@ -1,83 +0,0 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _ci_drone:
-
-Drone
-=====
-
-`Drone <https://drone.io>`_  is a hosted continuous integration service.
-It enables you to conveniently set up projects to automatically build, test,
-and deploy as you make changes to your code to
-`GitHub <http://en.wikipedia.org/wiki/GitHub>`_ and
-`BitBucket <http://en.wikipedia.org/wiki/Bitbucket>`_ repositories.
-
-Drone is configured by modifying settings in your project control panel.
-
-Drone automatically detects when a commit has been made and pushed to a
-GitHub repository that is using Drone, and each time this happens, it will
-try to build the project using :ref:`cmd_ci` command. This includes commits to
-all branches, not just to the master branch. Drone will also build and run
-pull requests. When that process has completed, it will notify a developer in
-the way it has been configured to do so — for example, by sending an email
-containing the build results (showing success or failure). It can be
-configured to build project on a range of different :ref:`platforms`.
-
-.. contents::
-
-Integration
------------
-
-Please fill all fields for your project in the Drone control panel:
-
-`Environment Variables`:
-
-.. code-block:: bash
-
-    PLATFORMIO_CI_SRC=path/to/source/file.c
-    PLATFORMIO_CI_SRC=path/to/source/file.ino
-    PLATFORMIO_CI_SRC=path/to/source/directory
-
-`Commands`:
-
-.. code-block:: bash
-
-    pip install -U platformio
-    platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-.. image:: ../_static/droneci-platformio-integration-1.png
-
-For more details as for PlatformIO build process please look into :ref:`cmd_ci`
-command.
-
-Examples
---------
-
-1. Integration for `USB_Host_Shield_2.0 <https://github.com/felis/USB_Host_Shield_2.0>`_
-   project. The ``circle.yml`` configuration file:
-
-`Environment Variables`:
-
-.. code-block:: bash
-
-    PLATFORMIO_CI_SRC=examples/Bluetooth/PS3SPP/PS3SPP.ino
-    PLATFORMIO_CI_SRC=examples/pl2303/pl2303_gps/pl2303_gps.ino
-
-`Commands`:
-
-.. code-block:: bash
-
-    pip install -U platformio
-    wget https://github.com/xxxajk/spi4teensy3/archive/master.zip -O /tmp/spi4teensy3.zip
-    unzip /tmp/spi4teensy3.zip -d /tmp
-    platformio ci --lib="." --lib="/tmp/spi4teensy3-master" --board=uno --board=teensy31 --board=due
-
-.. image:: ../_static/droneci-platformio-integration-2.png

docs/ci/index.rst

@@ -1,35 +0,0 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _ci:
-
-Continuous Integration
-======================
-
-`Continuous Integration (CI, wiki) <http://en.wikipedia.org/wiki/Continuous_integration>`_
-is the practice, in software engineering, of merging all developer working
-copies with a shared mainline several times a day.
-
-:ref:`cmd_ci` command is intended to be used in combination with the build
-servers and the popular
-`Continuous Integration Software <http://en.wikipedia.org/wiki/Comparison_of_continuous_integration_software>`_.
-
-By integrating regularly, you can detect errors quickly, and locate them more
-easily.
-
-.. toctree::
-    :maxdepth: 2
-
-    appveyor
-    circleci
-    drone
-    shippable
-    travis

docs/ci/shippable.rst

@@ -1,89 +0,0 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _ci_shippable:
-
-Shippable
-=========
-
-`Shippable <http://en.wikipedia.org/wiki/Shippable>`_ is a hosted cloud
-platform that provides hosted continuous integration, deployment, and testing
-to `GitHub <http://en.wikipedia.org/wiki/GitHub>`_ and
-`BitBucket <http://en.wikipedia.org/wiki/Bitbucket>`_ repositories.
-Shippable's continuous integration service is built using Docker.
-
-Shippable is configured by adding a file named ``shippable.yml``, which is a
-`YAML <http://en.wikipedia.org/wiki/YAML>`_ format text file, to the root
-directory of the GitHub repository or you can use your Travis CI configuration
-file ``.travis.yml``.
-
-Shippable automatically detects when a commit has been made and pushed to a
-GitHub repository that is using Shippable, and each time this happens, it will
-try to build the project using :ref:`cmd_ci` command. This includes commits to
-all branches, not just to the master branch. Shippable will also build and run
-pull requests. When that process has completed, it will notify a developer in
-the way it has been configured to do so — for example, by sending an email
-containing the build results (showing success or failure), or by posting a
-message on an IRC channel. It can be configured to build project on a range of
-different :ref:`platforms`.
-
-.. contents::
-
-Integration
------------
-
-Please put ``shippable.yml`` or ``.travis.yml`` to the root directory of the
-GitHub repository.
-
-.. code-block:: yaml
-
-    language: python
-    python:
-        - "2.7"
-
-    env:
-        - PLATFORMIO_CI_SRC=path/to/source/file.c
-        - PLATFORMIO_CI_SRC=path/to/source/file.ino
-        - PLATFORMIO_CI_SRC=path/to/source/directory
-
-    install:
-        - pip install -U platformio
-
-    script:
-        - platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-
-For more details as for PlatformIO build process please look into :ref:`cmd_ci`
-command.
-
-Examples
---------
-
-1. Integration for `USB_Host_Shield_2.0 <https://github.com/felis/USB_Host_Shield_2.0>`_
-   project. The ``shippable.yml`` or ``.travis.yml`` configuration file:
-
-.. code-block:: yaml
-
-    language: python
-    python:
-        - "2.7"
-
-    env:
-        - PLATFORMIO_CI_SRC=examples/Bluetooth/PS3SPP/PS3SPP.ino
-        - PLATFORMIO_CI_SRC=examples/pl2303/pl2303_gps/pl2303_gps.ino
-
-    install:
-        - pip install -U platformio
-        - wget https://github.com/xxxajk/spi4teensy3/archive/master.zip -O /tmp/spi4teensy3.zip
-        - unzip /tmp/spi4teensy3.zip -d /tmp
-
-    script:
-        - platformio ci --lib="." --lib="/tmp/spi4teensy3-master" --board=uno --board=teensy31 --board=due

docs/ci/travis.rst

@@ -1,269 +0,0 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _ci_travis:
-
-Travis CI
-=========
-
-.. image:: ../_static/ci-travis-logo.png
-    :target: https://docs.travis-ci.com/user/integration/platformio/
-
-
-**Travis CI** `officially supports <https://docs.travis-ci.com/user/integration/platformio/>`_
-**PlatformIO for Embedded Builds.**
-
-`Travis CI <http://en.wikipedia.org/wiki/Travis_CI>`_ is an open-source hosted,
-distributed continuous integration service used to build and test projects
-hosted at `GitHub <http://en.wikipedia.org/wiki/GitHub>`_.
-
-Travis CI is configured by adding a file named ``.travis.yml``, which is a
-`YAML <http://en.wikipedia.org/wiki/YAML>`_ format text file, to the root
-directory of the GitHub repository.
-
-Travis CI automatically detects when a commit has been made and pushed to a
-GitHub repository that is using Travis CI, and each time this happens, it will
-try to build the project using :ref:`cmd_ci` command. This includes commits to
-all branches, not just to the master branch. Travis CI will also build and run
-pull requests. When that process has completed, it will notify a developer in
-the way it has been configured to do so — for example, by sending an email
-containing the build results (showing success or failure), or by posting a
-message on an IRC channel. It can be configured to build project on a range of
-different :ref:`platforms`.
-
-.. contents::
-
-Integration
------------
-
-Please make sure to read Travis CI `Getting Started <http://docs.travis-ci.com/user/getting-started/>`_
-and `general build configuration <http://docs.travis-ci.com/user/customizing-the-build/>`_
-guides first.
-
-PlatformIO is written in Python and is recommended to be run within
-`Travis CI Python isolated environment <http://docs.travis-ci.com/user/languages/python/#Travis-CI-Uses-Isolated-virtualenvs>`_:
-
-.. code-block:: yaml
-
-    language: python
-    python:
-        - "2.7"
-
-    # Cache PlatformIO packages using Travis CI container-based infrastructure
-    sudo: false
-    cache:
-        directories:
-            - "~/.platformio"
-
-    env:
-        - PLATFORMIO_CI_SRC=path/to/test/file.c
-        - PLATFORMIO_CI_SRC=examples/file.ino
-        - PLATFORMIO_CI_SRC=path/to/test/directory
-
-    install:
-        - pip install -U platformio
-
-    script:
-        - platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-Then perform steps 1, 2 and 4 from http://docs.travis-ci.com/user/getting-started/
-
-For more details as for PlatformIO build process please look into :ref:`cmd_ci`.
-
-Project as a library
-~~~~~~~~~~~~~~~~~~~~
-
-When project is written as a library (where own examples or testing code use
-it), please use ``--lib="."`` option for :ref:`cmd_ci` command
-
-.. code-block:: yaml
-
-    script:
-        - platformio ci --lib="." --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-Library dependecies
-~~~~~~~~~~~~~~~~~~~
-
-There 2 options to test source code with dependent libraries:
-
-Install dependent library using :ref:`librarymanager`
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. code-block:: yaml
-
-    install:
-        - pip install -U platformio
-
-        #
-        # Libraries from PlatformIO Library Registry:
-        #
-        # http://platformio.org/lib/show/1/OneWire
-        - platformio lib install 1
-
-Manually download dependent library and include in build process via ``--lib`` option
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. code-block:: yaml
-
-    install:
-        - pip install -U platformio
-
-        # download library to the temporary directory
-        - wget https://github.com/PaulStoffregen/OneWire/archive/master.zip -O /tmp/onewire_source.zip
-        - unzip /tmp/onewire_source.zip -d /tmp/
-
-    script:
-        - platformio ci --lib="/tmp/OneWire-master" --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-Custom Build Flags
-~~~~~~~~~~~~~~~~~~
-
-PlatformIO allows to specify own build flags using :envvar:`PLATFORMIO_BUILD_FLAGS` environment
-
-.. code-block:: yaml
-
-    env:
-        - PLATFORMIO_CI_SRC=path/to/test/file.c PLATFORMIO_BUILD_FLAGS="-D SPECIFIC_MACROS_PER_TEST_ENV -I/extra/inc"
-        - PLATFORMIO_CI_SRC=examples/file.ino
-        - PLATFORMIO_CI_SRC=path/to/test/directory
-
-    install:
-        - pip install -U platformio
-        - export PLATFORMIO_BUILD_FLAGS="-D GLOBAL_MACROS_FOR_ALL_TEST_ENV"
-
-
-For the more details, please follow to
-:ref:`available build flags/options <projectconf_build_flags>`.
-
-
-Advanced configuration
-~~~~~~~~~~~~~~~~~~~~~~
-
-PlatformIO allows to configure multiple build environments for the single
-source code using :ref:`projectconf`.
-
-Instead of ``--board`` option, please use :option:`platformio ci --project-conf`
-
-.. code-block:: yaml
-
-    script:
-        - platformio ci --project-conf=/path/to/platoformio.ini
-
-Examples
---------
-
-1. Custom build flags
-
-.. code-block:: yaml
-
-    language: python
-    python:
-        - "2.7"
-
-    # Cache PlatformIO packages using Travis CI container-based infrastructure
-    sudo: false
-    cache:
-        directories:
-            - "~/.platformio"
-
-    env:
-        - PLATFORMIO_CI_SRC=examples/acm/acm_terminal
-        - PLATFORMIO_CI_SRC=examples/Bluetooth/WiiIRCamera PLATFORMIO_BUILD_FLAGS="-DWIICAMERA"
-        - PLATFORMIO_CI_SRC=examples/ftdi/USBFTDILoopback
-        - PLATFORMIO_CI_SRC=examples/Xbox/XBOXUSB
-        # - ...
-
-    install:
-        - pip install -U platformio
-
-        #
-        # Libraries from PlatformIO Library Registry:
-        #
-        # http://platformio.org/lib/show/416/TinyGPS
-        # http://platformio.org/lib/show/417/SPI4Teensy3
-        - platformio lib install 416 417
-
-    script:
-        - platformio ci --board=uno --board=teensy31 --board=due --lib="."
-
-* Configuration file: https://github.com/felis/USB_Host_Shield_2.0/blob/master/.travis.yml
-* Build History: https://travis-ci.org/felis/USB_Host_Shield_2.0
-
-2. Dependency on external libraries
-
-.. code-block:: yaml
-
-    language: python
-    python:
-        - "2.7"
-
-    # Cache PlatformIO packages using Travis CI container-based infrastructure
-    sudo: false
-    cache:
-        directories:
-            - "~/.platformio"
-
-    env:
-        - PLATFORMIO_CI_SRC=examples/backSoon/backSoon.ino
-        - PLATFORMIO_CI_SRC=examples/etherNode/etherNode.ino
-        # -
-
-    install:
-        - pip install -U platformio
-
-        - wget https://github.com/jcw/jeelib/archive/master.zip -O /tmp/jeelib.zip
-        - unzip /tmp/jeelib.zip -d /tmp
-
-        - wget https://github.com/Rodot/Gamebuino/archive/master.zip  -O /tmp/gamebuino.zip
-        - unzip /tmp/gamebuino.zip -d /tmp
-
-    script:
-        - platformio ci --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
-
-* Configuration file: https://github.com/jcw/ethercard/blob/master/.travis.yml
-* Build History: https://travis-ci.org/jcw/ethercard
-
-3. Dynamic testing of the boards
-
-.. code-block:: yaml
-
-    language: python
-    python:
-        - "2.7"
-
-    # Cache PlatformIO packages using Travis CI container-based infrastructure
-    sudo: false
-    cache:
-        directories:
-            - "~/.platformio"
-
-    env:
-        - PLATFORMIO_CI_SRC=examples/TimeArduinoDue PLATFORMIO_CI_EXTRA_ARGS="--board=due"
-        - PLATFORMIO_CI_SRC=examples/TimeGPS
-        - PLATFORMIO_CI_SRC=examples/TimeNTP
-        - PLATFORMIO_CI_SRC=examples/TimeTeensy3 PLATFORMIO_CI_EXTRA_ARGS="--board=teensy31"
-        # - ...
-
-    install:
-        - pip install -U platformio
-        - rm -rf ./linux
-
-        #
-        # Libraries from PlatformIO Library Registry:
-        #
-        # http://platformio.org/lib/show/416/TinyGPS
-        - platformio lib install 416 421 422
-
-    script:
-        - platformio ci --lib="." --board=uno --board=teensy20pp $PLATFORMIO_CI_EXTRA_ARGS
-
-* Configuration file: https://github.com/ivankravets/Time/blob/master/.travis.yml
-* Build History: https://travis-ci.org/ivankravets/Time

docs/conf.py

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

docs/demo.rst

@@ -1,78 +0,0 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _demo:
-
-Demo & Projects
-===============
-
-.. contents::
-
-Project Examples
-----------------
-
-Preconfigured demo projects are located in `PlatformIO GitHub <https://github.com/platformio/platformio-examples/tree/develop>`_ repository.
-
-"Blink Project"
----------------
-
-.. image:: _static/platformio-demo-wiring.gif
-
-Used in demo
-~~~~~~~~~~~~
-
-1. Source code of `Wiring Blink Example <https://github.com/platformio/platformio-examples/tree/develop/wiring-blink>`_
-2. :ref:`cmd_run` command
-3. :ref:`platformio run -t upload <cmd_run>` command.
-
-Platform Manager
-----------------
-
-.. image:: _static/platformio-demo-platforms.gif
-
-Used in demo
-~~~~~~~~~~~~
-
-1. :ref:`userguide_platforms`
-2. :ref:`cmd_platforms_list` command
-3. :ref:`platformio platforms search avr <cmd_platforms_search>` command
-4. :ref:`platformio platforms show teensy <cmd_platforms_show>` command
-5. :ref:`cmd_platforms_update` command.
-
-Library Manager
----------------
-
-.. image:: _static/platformio-demo-lib.gif
-
-Used in demo
-~~~~~~~~~~~~
-
-1. :ref:`userguide_lib`
-2. :ref:`platformio lib search 1-wire <cmd_lib_search>` command
-3. :ref:`platformio lib install 54 <cmd_lib_install>` command
-4. :ref:`platformio lib search -f mbed <cmd_lib_search>` command
-5. :ref:`platformio lib search -k rf <cmd_lib_search>` command
-6. :ref:`platformio lib search radiohead <cmd_lib_search>` command
-7. :ref:`platformio lib install 124 --version "1.40" <cmd_lib_install>` command
-8. :ref:`platformio lib show 124 <cmd_lib_show>` command
-9. :ref:`cmd_lib_update` command.
-
-Over-the-Air update for ESP8266
--------------------------------
-
-.. image:: _static/platformio-demo-ota-esp8266.jpg
-    :target: https://www.youtube.com/watch?v=lXchL3hpDO4
-
-Used in demo
-~~~~~~~~~~~~
-
-1. :ref:`cmd_run` command
-2. :ref:`platformio run -t upload <cmd_run>` command.

docs/envvars.rst

@@ -1,151 +0,0 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _envvars:
-
-Environment variables
-=====================
-
-`Environment variables <http://en.wikipedia.org/wiki/Environment_variable>`_
-are a set of dynamic named values that can affect the way running processes
-will behave on a computer.
-
-*PlatformIO* handles variables which start with ``PLATFORMIO_`` prefix. They
-have the **HIGHEST PRIORITY**.
-
-.. contents::
-
-General
--------
-
-PlatformIO uses *General* environment variables for the common
-operations/commands.
-
-.. envvar:: CI
-
-PlatformIO handles ``CI`` variable which is setup by
-`Continuous Integration <http://en.wikipedia.org/wiki/Continuous_integration>`_
-(Travis, Circle and etc.) systems.
-PlatformIO uses it to disable prompts and progress bars. In other words,
-``CI=true`` automatically setup :envvar:`PLATFORMIO_SETTING_ENABLE_PROMPTS` to
-``false`` and :envvar:`PLATFORMIO_DISABLE_PROGRESSBAR` to ``true``.
-
-.. envvar:: PLATFORMIO_FORCE_COLOR
-
-Force to output color ANSI-codes even if the output is a ``pipe`` (not a ``tty``).
-The possible values are ``true`` and ``false``. Default is ``PLATFORMIO_FORCE_COLOR=false``.
-
-.. envvar:: PLATFORMIO_DISABLE_PROGRESSBAR
-
-Disable progress bar for package/library downloader and uploader. This is
-useful when calling PlatformIO from subprocess and output is a ``pipe`` (not a ``tty``).
-The possible values are ``true`` and ``false``. Default is ``PLATFORMIO_DISABLE_PROGRESSBAR=false``.
-
-.. envvar:: PLATFORMIO_HOME_DIR
-
-Allows to override :ref:`projectconf` option :ref:`projectconf_pio_home_dir`.
-
-.. envvar:: PLATFORMIO_LIB_DIR
-
-Allows to override :ref:`projectconf` option :ref:`projectconf_pio_lib_dir`.
-
-.. envvar:: PLATFORMIO_SRC_DIR
-
-Allows to override :ref:`projectconf` option :ref:`projectconf_pio_src_dir`.
-
-.. envvar:: PLATFORMIO_ENVS_DIR
-
-Allows to override :ref:`projectconf` option :ref:`projectconf_pio_envs_dir`.
-
-.. envvar:: PLATFORMIO_DATA_DIR
-
-Allows to override :ref:`projectconf` option :ref:`projectconf_pio_data_dir`.
-
-
-Building
---------
-
-.. envvar:: PLATFORMIO_BUILD_FLAGS
-
-Allows to set :ref:`projectconf` option :ref:`projectconf_build_flags`.
-
-Examples:
-
-.. code-block:: bash
-
-    # Unix:
-    export PLATFORMIO_BUILD_FLAGS=-DFOO
-    export PLATFORMIO_BUILD_FLAGS="-DFOO -DBAR=1 -DFLOAT_VALUE=1.23457e+07"
-    export PLATFORMIO_BUILD_FLAGS="'-DWIFI_PASS=\"My password\"' '-DWIFI_SSID=\"My ssid name\"'"
-
-    # Windows:
-    SET PLATFORMIO_BUILD_FLAGS=-DFOO
-    SET PLATFORMIO_BUILD_FLAGS=-DFOO -DBAR=1 -DFLOAT_VALUE=1.23457e+07
-    SET PLATFORMIO_BUILD_FLAGS='-DWIFI_PASS="My password"' '-DWIFI_SSID="My ssid name"'
-
-.. envvar:: PLATFORMIO_SRC_BUILD_FLAGS
-
-Allows to set :ref:`projectconf` option :ref:`projectconf_src_build_flags`.
-
-.. envvar:: PLATFORMIO_SRC_FILTER
-
-Allows to set :ref:`projectconf` option :ref:`projectconf_src_filter`.
-
-.. envvar:: PLATFORMIO_EXTRA_SCRIPT
-
-Allows to set :ref:`projectconf` option :ref:`projectconf_extra_script`.
-
-
-Uploading
----------
-
-.. envvar:: PLATFORMIO_UPLOAD_PORT
-
-Allows to set :ref:`projectconf` option :ref:`projectconf_upload_port`.
-
-.. envvar:: PLATFORMIO_UPLOAD_FLAGS
-
-Allows to set :ref:`projectconf` option :ref:`projectconf_upload_flags`.
-
-
-Settings
---------
-
-Allows to override PlatformIO settings. You can manage them via
-:ref:`cmd_settings` command.
-
-.. envvar:: PLATFORMIO_SETTING_AUTO_UPDATE_LIBRARIES
-
-Allows to override setting :ref:`setting_auto_update_libraries`.
-
-.. envvar:: PLATFORMIO_SETTING_AUTO_UPDATE_PLATFORMS
-
-Allows to override setting :ref:`setting_auto_update_platforms`.
-
-.. envvar:: PLATFORMIO_SETTING_CHECK_LIBRARIES_INTERVAL
-
-Allows to override setting :ref:`setting_check_libraries_interval`.
-
-.. envvar:: PLATFORMIO_SETTING_CHECK_PLATFORMIO_INTERVAL
-
-Allows to override setting :ref:`setting_check_platformio_interval`.
-
-.. envvar:: PLATFORMIO_SETTING_CHECK_PLATFORMS_INTERVAL
-
-Allows to override setting :ref:`setting_check_platforms_interval`.
-
-.. envvar:: PLATFORMIO_SETTING_ENABLE_PROMPTS
-
-Allows to override setting :ref:`setting_enable_prompts`.
-
-.. envvar:: PLATFORMIO_SETTING_ENABLE_TELEMETRY
-
-Allows to override setting :ref:`setting_enable_telemetry`.

docs/faq.rst

@@ -1,178 +0,0 @@
-..  Copyright 2014-2016 Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _faq:
-
-Frequently Asked Questions
-==========================
-
-.. note::
-   We have a big database with `Frequently Asked Questions in our Community Forums <https://community.platformio.org/c/faq>`_.
-   Please have a look at it.
-
-.. contents::
-
-General
--------
-
-What is PlatformIO?
-~~~~~~~~~~~~~~~~~~~
-
-Please refer to :ref:`what_is_pio`
-
-What is ``.pioenvs`` directory
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Please refer to :ref:`projectconf_pio_envs_dir`.
-
-Command completion in Terminal
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Bash completion
-'''''''''''''''
-
-Bash completion support will complete subcommands and parameters. To enable
-Bash completion for `platformio` subcommands you need to put into your `.bashrc`:
-
-.. code-block:: bash
-
-    eval "$(_PLATFORMIO_COMPLETE=source platformio)"
-    eval "$(_PLATFORMIO_COMPLETE=source pio)"
-
-ZSH completion
-''''''''''''''
-
-To enable ``zsh`` completion please run these commands:
-
-.. code-block:: bash
-
-    autoload bashcompinit && bashcompinit
-    eval "$(_PLATFORMIO_COMPLETE=source platformio)"
-    eval "$(_PLATFORMIO_COMPLETE=source pio)"
-
-.. note::
-
-    For permanent command completion you need to place commands above to
-    ``~/.bashrc`` or ``~/.zshrc`` file.
-
-PlatformIO IDE
---------------
-
-Please refer to :ref:`PlatformIO IDE Frequently Asked Questions <ide_atom_faq>`.
-
-.. _faq_troubleshooting:
-
-Troubleshooting
----------------
-
-Installation
-~~~~~~~~~~~~
-
-[Errno 1] Operation not permitted
-'''''''''''''''''''''''''''''''''
-
-Answered in `issue #295 <https://github.com/platformio/platformio/issues/295#issuecomment-143772005>`_.
-
-Windows AttributeError: 'module' object has no attribute 'packages'
-'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-Answered in `issue #252 <https://github.com/platformio/platformio/issues/252#issuecomment-127072039>`_.
-
-.. _faq_troubleshooting_pionotfoundinpath:
-
-Program "platformio" not found in PATH
-''''''''''''''''''''''''''''''''''''''
-
-Where is ``platformio`` binary installed? Run this command in Terminal
-
-.. code-block:: bash
-
-    # for Unix
-    which platformio
-    echo $PATH
- Windows OS
-    where platformio
-    echo %PATH%
-
-For example, ``which platformio`` is equal to ``/usr/local/bin/platformio``,
-then `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_
-should contain ``/usr/local/bin`` directory.
-
-**Unix Users**: You can make "symlinks" from ``platformio`` program to the
-``bin`` directory which is included in ``$PATH``. For example,
-see `issue #272 <https://github.com/platformio/platformio/issues/272#issuecomment-133626112>`_.
-
-Windows UnicodeDecodeError: 'ascii' codec can't decode byte
-'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-Answered in `issue #143 <https://github.com/platformio/platformio/issues/143#issuecomment-88060906>`_.
-
-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
-
-Miscellaneous
-~~~~~~~~~~~~~
-
-.. _faq_troubleshooting_pioblocksprompt:
-
-PlatformIO blocks command execution using user prompt
-'''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-If you are going to run *PlatformIO* from **subprocess**, you **MUST
-DISABLE** all prompts. It will allow you to avoid blocking.
-There are a few options:
-
-- using :option:`platformio --force` option before each command
-- using environment variable :envvar:`PLATFORMIO_SETTING_ENABLE_PROMPTS=No <PLATFORMIO_SETTING_ENABLE_PROMPTS>`
-- disable global setting ``enable_prompts`` via :ref:`cmd_settings` command
-- masking under Continuous Integration system via environment variable
-  :envvar:`CI=true <CI>`.
-
-Serial does not work with panStampAVR board
-'''''''''''''''''''''''''''''''''''''''''''
-
-Answered in `issue #144 <https://github.com/platformio/platformio/issues/144#issuecomment-87388038>`_.
-
-Building
-~~~~~~~~
-
-Can not compile a library that compiles without issue with Arduino IDE
-''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-* `#298: Unable to use Souliss library <https://github.com/platformio/platformio/issues/298>`_
-* `#331: Unable to use MySensors library <https://github.com/platformio/platformio/issues/331>`_
-
-ARM toolchain: cc1plus: error while loading shared libraries
-''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-See related answers for
-`error while loading shared libraries <https://github.com/platformio/platformio/issues?utf8=✓&q=error+while+loading+shared+libraries>`_.
-
-Archlinux: libncurses.so.5: cannot open shared object file
-''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-Answered in `issue #291 <https://github.com/platformio/platformio/issues/291>`_.
-
-Monitoring a serial port breaks upload
-''''''''''''''''''''''''''''''''''''''
-
-Answered in `issue #384 <https://github.com/platformio/platformio/issues/384>`_.

docs/frameworks/cmsis.rst

@@ -1,116 +0,0 @@
-..  Copyright 2014-present Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _framework_cmsis:
-
-Framework ``cmsis``
-===================
-The ARM Cortex Microcontroller Software Interface Standard (CMSIS) is a vendor-independent hardware abstraction layer for the Cortex-M processor series and specifies debugger interfaces. The CMSIS enables consistent and simple software interfaces to the processor for interface peripherals, real-time operating systems, and middleware. It simplifies software re-use, reducing the learning curve for new microcontroller developers and cutting the time-to-market for devices.
-
-For more detailed information please visit `vendor site <http://www.arm.com/products/processors/cortex-m/cortex-microcontroller-software-interface-standard.php>`_.
-
-.. contents::
-
-Platforms
----------
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Description
-
-    * - :ref:`platform_ststm32`
-      - The STM32 family of 32-bit Flash MCUs based on the ARM Cortex-M processor is designed to offer new degrees of freedom to MCU users. It offers a 32-bit product range that combines very high performance, real-time capabilities, digital signal processing, and low-power, low-voltage operation, while maintaining full integration and ease of development.
-
-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.
-
-Armstrap
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``armstrap_eagle1024``
-      - `Armstrap Eagle 1024 <http://docs.armstrap.org/en/latest/hardware-overview.html>`_
-      - STM32F417VGT6
-      - 168 MHz
-      - 1024 Kb
-      - 192 Kb
-
-    * - ``armstrap_eagle2048``
-      - `Armstrap Eagle 2048 <http://docs.armstrap.org/en/latest/hardware-overview.html>`_
-      - STM32F427VIT6
-      - 168 MHz
-      - 2048 Kb
-      - 256 Kb
-
-    * - ``armstrap_eagle512``
-      - `Armstrap Eagle 512 <http://docs.armstrap.org/en/latest/hardware-overview.html>`_
-      - STM32F407VET6
-      - 168 MHz
-      - 512 Kb
-      - 192 Kb
-
-ST
-~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``disco_f303vc``
-      - `ST STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
-      - STM32F303VCT6
-      - 72 MHz
-      - 256 Kb
-      - 48 Kb
-
-    * - ``disco_f407vg``
-      - `ST STM32F4DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF252419>`_
-      - STM32F407VGT6
-      - 168 MHz
-      - 1024 Kb
-      - 128 Kb
-
-    * - ``disco_l152rb``
-      - `ST STM32LDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF258515>`_
-      - STM32L152RBT6
-      - 32 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``nucleo_f401re``
-      - `ST Nucleo F401RE <https://developer.mbed.org/platforms/ST-Nucleo-F401RE/>`_
-      - STM32F401RET6
-      - 84 MHz
-      - 512 Kb
-      - 96 Kb
-
-.. include:: cmsis_extra.rst

docs/frameworks/cmsis_extra.rst

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

docs/frameworks/energia.rst

@@ -1,139 +0,0 @@
-..  Copyright 2014-present Ivan Kravets <me@ikravets.com>
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
-       http://www.apache.org/licenses/LICENSE-2.0
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
-
-.. _framework_energia:
-
-Framework ``energia``
-=====================
-Energia Wiring-based framework enables pretty much anyone to start easily creating microcontroller-based projects and applications. Its easy-to-use libraries and functions provide developers of all experience levels to start blinking LEDs, buzzing buzzers and sensing sensors more quickly than ever before.
-
-For more detailed information please visit `vendor site <http://energia.nu/reference/>`_.
-
-.. contents::
-
-Platforms
----------
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Description
-
-    * - :ref:`platform_timsp430`
-      - MSP430 microcontrollers (MCUs) from Texas Instruments (TI) are 16-bit, RISC-based, mixed-signal processors designed for ultra-low power. These MCUs offer the lowest power consumption and the perfect mix of integrated peripherals for thousands of applications.
-
-    * - :ref:`platform_titiva`
-      - Texas Instruments TM4C12x MCUs offer the industrys most popular ARM Cortex-M4 core with scalable memory and package options, unparalleled connectivity peripherals, advanced application functions, industry-leading analog integration, and extensive software solutions.
-
-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.
-
-TI
-~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``lplm4f120h5qr``
-      - `TI LaunchPad (Stellaris) w/ lm4f120 (80MHz) <http://www.ti.com/tool/ek-lm4f120xl>`_
-      - LPLM4F120H5QR
-      - 80 MHz
-      - 256 Kb
-      - 32 Kb
-
-    * - ``lpmsp430f5529``
-      - `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``
-      - `TI LaunchPad w/ msp430f5529 (25MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html>`_
-      - MSP430F5529
-      - 25 MHz
-      - 128 Kb
-      - 1 Kb
-
-    * - ``lpmsp430fr4133``
-      - `TI LaunchPad w/ msp430fr4133 <http://www.ti.com/tool/msp-exp430fr4133>`_
-      - MSP430FR4133
-      - 16 MHz
-      - 16 Kb
-      - 2 Kb
-
-    * - ``lpmsp430fr5739``
-      - `TI FraunchPad w/ msp430fr5739 <http://www.ti.com/tool/msp-exp430fr5739>`_
-      - MSP430FR5739
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``lpmsp430fr5969``
-      - `TI LaunchPad w/ msp430fr5969 <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430fr5969.html>`_
-      - MSP430FR5969
-      - 8 MHz
-      - 64 Kb
-      - 1 Kb
-
-    * - ``lpmsp430fr6989``
-      - `TI LaunchPad w/ msp430fr6989 <http://www.ti.com/tool/msp-exp430fr6989>`_
-      - MSP430FR6989
-      - 16 MHz
-      - 128 Kb
-      - 2 Kb
-
-    * - ``lpmsp430g2231``
-      - `TI LaunchPad w/ msp430g2231 (1 MHz) <http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430g2.html>`_
-      - MSP430G2231
-      - 1 MHz
-      - 2 Kb
-      - 0.125 Kb
-
-    * - ``lpmsp430g2452``
-      - `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``
-      - `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``
-      - `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``
-      - `TI LaunchPad (Tiva C) w/ tm4c129 (120MHz) <http://www.ti.com/ww/en/launchpad/launchpads-connected-ek-tm4c1294xl.html>`_
-      - LPTM4C1294NCPDT
-      - 120 MHz
-      - 1024 Kb
-      - 256 Kb

docs/frameworks/index.rst

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