Merge branch 'release/v6.1.16'

* allow manual override of system type
https://community.platformio.org/t/windows-on-arm64-problem-installing-xtensa-toolchain/25497

* fix lint

.github/FUNDING.yml

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

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,63 @@
+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 [Community Forums](https://community.platformio.org) or [Premium Support](https://platformio.org/support)
+
+- [ ] **PlatformIO IDE**.
+      All issues related to PlatformIO IDE should be reported to the
+      [PlatformIO IDE for VSCode](https://github.com/platformio/platformio-vscode-ide/issues) repository
+
+- [ ] **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 Core**.
+      If you’ve found a bug, please provide an information below.
+
+
+*You can erase any parts of this template not applicable to your Issue.*
+
+------------------------------------------------------------------
+
+### Configuration
+
+**Operating system**:
+
+**PlatformIO Version** (`platformio --version`):
+
+### Description of problem
+
+
+#### Steps to Reproduce
+
+1.
+2.
+3.
+
+### Actual Results
+
+
+### Expected Results
+
+
+### If problems with PlatformIO Build System:
+
+**The content of `platformio.ini`:**
+```ini
+Insert here...
+```
+
+**Source file to reproduce issue:**
+```cpp
+Insert here...
+```
+
+### Additional info

.github/workflows/core.yml

@@ -0,0 +1,47 @@
+name: Core
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.11", "3.12", "3.13.0-rc.2"]
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: "recursive"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+
+      - name: Core System Info
+        run: |
+          tox -e py
+
+      - name: Integration Tests
+        if: ${{ matrix.python-version == '3.11' }}
+        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 }}
+          token: ${{ secrets.SLACK_GITHUB_TOKEN }}

.github/workflows/deployment.yml

@@ -0,0 +1,46 @@
+name: Deployment
+
+on:
+  push:
+    branches:
+      - "master"
+      - "release/**"
+
+jobs:
+  deployment:
+    runs-on: ubuntu-latest
+    environment: production
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: "recursive"
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox wheel
+
+      - name: Deployment 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: Build Python source tarball
+        # run:  python setup.py sdist bdist_wheel
+        run:  python setup.py sdist
+
+      - name: Publish package to PyPI
+        if: ${{ github.ref == 'refs/heads/master' }}
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}

.github/workflows/docs.yml

@@ -0,0 +1,109 @@
+name: Docs
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    name: Build Docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: "recursive"
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+      - 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 }}
+          token: ${{ secrets.SLACK_GITHUB_TOKEN }}
+
+      - name: Preserve Docs
+        if: ${{ github.event_name == 'push' }}
+        run: |
+          tar -czvf docs.tar.gz -C docs/_build html rtdpage
+
+      - name: Save artifact
+        if: ${{ github.event_name == 'push' }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: docs
+          path: ./docs.tar.gz
+
+  deploy:
+    name: Deploy Docs
+    needs: build
+    runs-on: ubuntu-latest
+    env:
+      DOCS_REPO: platformio/platformio-docs
+      DOCS_DIR: platformio-docs
+      LATEST_DOCS_DIR: latest-docs
+      RELEASE_BUILD: ${{ startsWith(github.ref, 'refs/tags/v') }}
+    if: ${{ github.event_name == 'push' }}
+    steps:
+      - name: Download artifact
+        uses: actions/download-artifact@v3
+        with:
+          name: docs
+      - name: Unpack artifact
+        run: |
+          mkdir ./${{ env.LATEST_DOCS_DIR }}
+          tar -xzf ./docs.tar.gz -C ./${{ env.LATEST_DOCS_DIR }}
+      - name: Delete Artifact
+        uses: geekyeggo/delete-artifact@v2
+        with:
+          name: docs
+      - name: Select Docs type
+        id: get-destination-dir
+        run: |
+          if [[ ${{ env.RELEASE_BUILD }} == true ]]; then
+            echo "::set-output name=dst_dir::stable"
+          else
+            echo "::set-output name=dst_dir::latest"
+          fi
+      - name: Checkout latest Docs
+        continue-on-error: true
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ env.DOCS_REPO }}
+          path: ${{ env.DOCS_DIR }}
+          ref: gh-pages
+      - name: Synchronize Docs
+        run: |
+          rm -rf ${{ env.DOCS_DIR }}/.git
+          rm -rf ${{ env.DOCS_DIR }}/en/${{ steps.get-destination-dir.outputs.dst_dir }}
+          mkdir -p ${{ env.DOCS_DIR }}/en/${{ steps.get-destination-dir.outputs.dst_dir }}
+          cp -rf ${{ env.LATEST_DOCS_DIR }}/html/* ${{ env.DOCS_DIR }}/en/${{ steps.get-destination-dir.outputs.dst_dir }}
+          if [[ ${{ env.RELEASE_BUILD }} == false ]]; then
+            rm -rf ${{ env.DOCS_DIR }}/page
+            mkdir -p ${{ env.DOCS_DIR }}/page
+            cp -rf ${{ env.LATEST_DOCS_DIR }}/rtdpage/* ${{ env.DOCS_DIR }}/page
+          fi
+      - name: Validate Docs
+        run: |
+          if [ -z "$(ls -A ${{ env.DOCS_DIR }})" ]; then
+             echo "Docs folder is empty. Aborting!"
+             exit 1
+          fi
+      - name: Deploy to Github Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          personal_token: ${{ secrets.DEPLOY_GH_DOCS_TOKEN }}
+          external_repository: ${{ env.DOCS_REPO }}
+          publish_dir: ./${{ env.DOCS_DIR }}
+          commit_message: Sync Docs

.github/workflows/examples.yml

@@ -0,0 +1,63 @@
+name: Examples
+
+on: [push, pull_request]
+
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    env:
+      PIO_INSTALL_DEVPLATFORM_OWNERNAMES: "platformio"
+      PIO_INSTALL_DEVPLATFORM_NAMES: "aceinna_imu,atmelavr,atmelmegaavr,atmelsam,espressif32,espressif8266,nordicnrf52,raspberrypi,ststm32,teensy"
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: "recursive"
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+
+      - name: Run on Linux
+        if: startsWith(matrix.os, 'ubuntu')
+        run: |
+          # Free space
+          sudo apt clean
+          docker rmi $(docker image ls -aq)
+          df -h
+          tox -e testexamples
+
+      - name: Run on macOS
+        if: startsWith(matrix.os, 'macos')
+        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
+        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 }}
+          token: ${{ secrets.SLACK_GITHUB_TOKEN }}

.github/workflows/projects.yml

@@ -0,0 +1,56 @@
+name: Projects
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        project:
+          - marlin:
+            repository: "MarlinFirmware/Marlin"
+            folder: "Marlin"
+            config_dir: "Marlin"
+            env_name: "mega2560"
+          - smartknob:
+            repository: "scottbez1/smartknob"
+            folder: "smartknob"
+            config_dir: "smartknob"
+            env_name: "view"
+          - espurna:
+            repository: "xoseperez/espurna"
+            folder: "espurna"
+            config_dir: "espurna/code"
+            env_name: "nodemcu-lolin"
+          - OpenMQTTGateway:
+            repository: "1technophile/OpenMQTTGateway"
+            folder: "OpenMQTTGateway"
+            config_dir: "OpenMQTTGateway"
+            env_name: "esp32-m5atom-lite"
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: "recursive"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.11
+
+      - name: Install PlatformIO
+        run: pip install -U .
+
+      - name: Check out ${{ matrix.project.repository }}
+        uses: actions/checkout@v4
+        with:
+          submodules: "recursive"
+          repository: ${{ matrix.project.repository }}
+          path: ${{ matrix.project.folder }}
+
+      - name: Compile ${{ matrix.project.repository }}
+        run: pio run -d ${{ matrix.project.config_dir }} -e ${{ matrix.project.env_name }}
+

.gitignore

@@ -1,7 +1,12 @@
 *.egg-info
 *.pyc
-.pioenvs
+__pycache__
 .tox
-.sconsign.dblite
 docs/_build
 dist
+build
+.cache
+coverage.xml
+.coverage
+htmlcov
+.pytest_cache

.gitmodules

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

.isort.cfg

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

.pylintrc

@@ -1,281 +1,12 @@
-[MASTER]
-
-# Specify a configuration file.
-#rcfile=
-
-# Python code to execute, usually for sys.path manipulation such as
-# pygtk.require().
-#init-hook=
-
-# Profiled execution.
-profile=no
-
-# Add files or directories to the blacklist. They should be base names, not
-# paths.
-ignore=CVS
-
-# Pickle collected data for later comparisons.
-persistent=yes
-
-# List of plugins (as comma separated values of python modules names) to load,
-# usually to register additional checkers.
-load-plugins=
-
+[REPORTS]
+output-format=colorized
 
 [MESSAGES CONTROL]
-
-# 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=C0103,C0111,E0611,F0401,I0011,R0801,R0903,R0922
-
-
-[REPORTS]
-
-# Set the output format. Available formats are text, parseable, colorized, msvs
-# (visual studio) and html. You can also give a reporter class, eg
-# mypackage.mymodule.MyReporterClass.
-output-format=text
-
-# Put messages in a separate file for each module / package specified on the
-# command line instead of printing them on stdout. Reports (if any) will be
-# written in a file name "pylint_global.[txt|html]".
-files-output=no
-
-# Tells whether to display a full report or only the messages
-reports=yes
-
-# Python expression which should return a note less than 10 (10 is the highest
-# note). You have access to the variables errors warning, statement which
-# respectively contain the number of errors / warnings messages and the total
-# number of statements analyzed. This is used by the global evaluation report
-# (RP0004).
-evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)
-
-# Add a comment according to your evaluation note. This is used by the global
-# evaluation report (RP0004).
-comment=no
-
-# Template used to display messages. This is a python new-style format string
-# used to format the message information. See doc for all details
-#msg-template=
-msg-template={path}:{line}: [{msg_id}({symbol}), {obj}] {msg}
-
-
-[BASIC]
-
-# Required attributes for module, separated by a comma
-required-attributes=
-
-# List of builtins function names that should not be used, separated by a comma
-bad-functions=map,filter,apply,input
-
-# Regular expression which should only match correct module names
-module-rgx=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
-
-# Regular expression which should only match correct module level names
-const-rgx=(([A-Z_][A-Z0-9_]*)|(__.*__))$
-
-# Regular expression which should only match correct class names
-class-rgx=[A-Z_][a-zA-Z0-9]+$
-
-# Regular expression which should only match correct function names
-function-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match correct method names
-method-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match correct instance attribute names
-attr-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match correct argument names
-argument-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match correct variable names
-variable-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match correct attribute names in class
-# bodies
-class-attribute-rgx=([A-Za-z_][A-Za-z0-9_]{2,30}|(__.*__))$
-
-# Regular expression which should only match correct list comprehension /
-# generator expression variable names
-inlinevar-rgx=[A-Za-z_][A-Za-z0-9_]*$
-
-# Good variable names which should always be accepted, separated by a comma
-good-names=i,j,k,ex,Run,_
-
-# Bad variable names which should always be refused, separated by a comma
-bad-names=foo,bar,baz,toto,tutu,tata
-
-# Regular expression which should only match function or class names that do
-# not require a docstring.
-no-docstring-rgx=__.*__
-
-# Minimum line length for functions/classes that require docstrings, shorter
-# ones are exempt.
-docstring-min-length=-1
-
-
-[FORMAT]
-
-# Maximum number of characters on a single line.
-max-line-length=80
-
-# Regexp for a line that is allowed to be longer than the limit.
-ignore-long-lines=^\s*(# )?<?https?://\S+>?$
-
-# Allow the body of an if to be on the same line as the test if there is no
-# else.
-single-line-if-stmt=no
-
-# List of optional constructs for which whitespace checking is disabled
-no-space-check=trailing-comma,dict-separator
-
-# Maximum number of lines in a module
-max-module-lines=1000
-
-# String used as indentation unit. This is usually " " (4 spaces) or "\t" (1
-# tab).
-indent-string='    '
-
-
-[MISCELLANEOUS]
-
-# List of note tags to take in consideration, separated by a comma.
-notes=FIXME,XXX,TODO
-
-
-[SIMILARITIES]
-
-# Minimum lines number of a similarity.
-min-similarity-lines=4
-
-# Ignore comments when computing similarities.
-ignore-comments=yes
-
-# Ignore docstrings when computing similarities.
-ignore-docstrings=yes
-
-# Ignore imports when computing similarities.
-ignore-imports=no
-
-
-[TYPECHECK]
-
-# Tells whether missing members accessed in mixin class should be ignored. A
-# mixin class is detected if its name ends with "mixin" (case insensitive).
-ignore-mixin-members=yes
-
-# List of classes names for which member attributes should not be checked
-# (useful for classes with attributes dynamically set).
-ignored-classes=SQLObject
-
-# When zope mode is activated, add a predefined set of Zope acquired attributes
-# to generated-members.
-zope=no
-
-# List of members which are set dynamically and missed by pylint inference
-# system, and so shouldn't trigger E0201 when accessed. Python regular
-# expressions are accepted.
-generated-members=REQUEST,acl_users,aq_parent
-
-
-[VARIABLES]
-
-# Tells whether we should check for unused import in __init__ files.
-init-import=no
-
-# A regular expression matching the beginning of the name of dummy variables
-# (i.e. not used).
-dummy-variables-rgx=_$|dummy
-
-# List of additional names supposed to be defined in builtins. Remember that
-# you should avoid to define new builtins when possible.
-additional-builtins=
-
-
-[CLASSES]
-
-# List of interface methods to ignore, separated by a comma. This is used for
-# instance to not check methods defines in Zope's Interface base class.
-ignore-iface-methods=isImplementedBy,deferred,extends,names,namesAndDescriptions,queryDescriptionFor,getBases,getDescriptionFor,getDoc,getName,getTaggedValue,getTaggedValueTags,isEqualOrExtendedBy,setTaggedValue,isImplementedByInstancesOf,adaptWith,is_implemented_by
-
-# List of method names used to declare (i.e. assign) instance attributes.
-defining-attr-methods=__init__,__new__,setUp
-
-# List of valid names for the first argument in a class method.
-valid-classmethod-first-arg=cls
-
-# List of valid names for the first argument in a metaclass class method.
-valid-metaclass-classmethod-first-arg=mcs
-
-
-[DESIGN]
-
-# Maximum number of arguments for function / method
-max-args=5
-
-# Argument names that match this expression will be ignored. Default to name
-# with leading underscore
-ignored-argument-names=_.*
-
-# Maximum number of locals for function / method body
-max-locals=15
-
-# Maximum number of return / yield for function / method body
-max-returns=6
-
-# Maximum number of branch for function / method body
-max-branches=12
-
-# Maximum number of statements in function / method body
-max-statements=50
-
-# Maximum number of parents for a class (see R0901).
-max-parents=7
-
-# Maximum number of attributes for a class (see R0902).
-max-attributes=7
-
-# Minimum number of public methods for a class (see R0903).
-min-public-methods=2
-
-# Maximum number of public methods for a class (see R0904).
-max-public-methods=20
-
-
-[IMPORTS]
-
-# Deprecated modules which should not be used, separated by a comma
-deprecated-modules=regsub,TERMIOS,Bastion,rexec
-
-# Create a graph of every (i.e. internal and external) dependencies in the
-# given file (report RP0402 must not be disabled)
-import-graph=
-
-# Create a graph of external dependencies in the given file (report RP0402 must
-# not be disabled)
-ext-import-graph=
-
-# Create a graph of internal dependencies in the given file (report RP0402 must
-# not be disabled)
-int-import-graph=
-
-
-[EXCEPTIONS]
-
-# Exceptions that will emit a warning when being caught. Defaults to
-# "Exception"
-overgeneral-exceptions=Exception
+disable=
+    missing-docstring,
+    duplicate-code,
+    invalid-name,
+    too-few-public-methods,
+    consider-using-f-string,
+    cyclic-import,
+    use-dict-literal

.travis.yml

@@ -1,15 +0,0 @@
-language: python
-python:
-    - "2.7"
-
-env:
-    - TOX_ENV=docs
-    - TOX_ENV=lint
-    - TOX_ENV=py26
-    - TOX_ENV=py27
-
-install:
-    - pip install -U pip setuptools tox
-
-script:
-    - tox -e $TOX_ENV

CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+# Code of Conduct
+
+See https://piolabs.com/legal/code-of-conduct.html

CONTRIBUTING.md

@@ -0,0 +1,22 @@
+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 the PlatformIO Core project where `tox.ini` is located (``cd platformio-core``) and run `tox -e py39`.
+   You can replace `py39` with your own Python version. For example, `py311` means Python 3.11.
+5. Activate current development environment:
+
+   * Windows: `.tox\py39\Scripts\activate`
+   * Bash/ZSH: `source .tox/py39/bin/activate`
+   * Fish: `source .tox/py39/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

HISTORY.rst

@@ -1,600 +1,379 @@
-Release History
-===============
+Release Notes
+=============
 
-PlatformIO 2.0
---------------
+.. |PIOCONF| replace:: `"platformio.ini" <https://docs.platformio.org/en/latest/projectconf.html>`__ configuration file
+.. |LIBRARYJSON| replace:: `library.json <https://docs.platformio.org/en/latest/manifests/library-json/index.html>`__
+.. |LDF| replace:: `LDF <https://docs.platformio.org/en/latest/librarymanager/ldf.html>`__
+.. |INTERPOLATION| replace:: `Interpolation of Values <https://docs.platformio.org/en/latest/projectconf/interpolation.html>`__
+.. |UNITTESTING| replace:: `Unit Testing <https://docs.platformio.org/en/latest/advanced/unit-testing/index.html>`__
+.. |DEBUGGING| replace:: `Debugging <https://docs.platformio.org/en/latest/plus/debugging.html>`__
+.. |STATICCODEANALYSIS| replace:: `Static Code Analysis <https://docs.platformio.org/en/latest/advanced/static-code-analysis/index.html>`__
 
-2.3.1 (2015-09-06)
-~~~~~~~~~~~~~~~~~~
+.. _release_notes_6:
 
-* Fixed critical issue when `platformio init --ide <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`__ command hangs PlatformIO
-  (`issue #283 <https://github.com/platformio/platformio/issues/283>`_)
+PlatformIO Core 6
+-----------------
 
-2.3.0 (2015-09-05)
-~~~~~~~~~~~~~~~~~~
+Unlock the true potential of embedded software development with
+PlatformIO's collaborative ecosystem, embracing declarative principles,
+test-driven methodologies, and modern toolchains for unrivaled success.
 
-* Added
-  `native <http://docs.platformio.org/en/latest/platforms/native.html>`__,
-  `linux_arm <http://docs.platformio.org/en/latest/platforms/linux_arm.html>`__,
-  `linux_i686 <http://docs.platformio.org/en/latest/platforms/linux_i686.html>`__,
-  `linux_x86_64 <http://docs.platformio.org/en/latest/platforms/linux_x86_64.html>`__,
-  `windows_x86 <http://docs.platformio.org/en/latest/platforms/windows_x86.html>`__
-  development platforms
-  (`issue #263 <https://github.com/platformio/platformio/issues/263>`_)
-* Added `PlatformIO Demo <http://docs.platformio.org/en/latest/demo.html>`_
-  page to documentation
-* Simplified `installation <http://docs.platformio.org/en/latest/installation.html>`__
-  process of PlatformIO
-  (`issue #274 <https://github.com/platformio/platformio/issues/274>`_)
-* Significantly improved `Project Generator <http://docs.platformio.org/en/latest/userguide/cmd_init.html#cmdoption-platformio-init--ide>`__ which allows to integrate with `the most popular
-  IDE <http://docs.platformio.org/en/latest/ide.html>`__
-* Added short ``-h`` help option for PlatformIO and sub-commands
-* Updated `mbed <http://docs.platformio.org/en/latest/frameworks/mbed.html>`__
-  framework
-* Updated ``tool-teensy`` package for `Teensy <http://docs.platformio.org/en/latest/platforms/teensy.html>`__
-  platform
-  (`issue #268 <https://github.com/platformio/platformio/issues/268>`_)
-* Added FAQ answer when `Program "platformio" not found in PATH <http://docs.platformio.org/en/latest/faq.html#faq-troubleshooting-pionotfoundinpath>`_
-  (`issue #272 <https://github.com/platformio/platformio/issues/272>`_)
-* Generate "readme.txt" for project "lib" directory
-  (`issue #273 <https://github.com/platformio/platformio/issues/273>`_)
-* Use toolchain's includes pattern ``include*`` for Project Generator
-  (`issue #277 <https://github.com/platformio/platformio/issues/277>`_)
-* Added support for Adafruit Gemma board to
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
-  platform
-  (`pull #256 <https://github.com/platformio/platformio/pull/256>`_)
-* Fixed includes list for Windows OS when generating project for `Eclipse IDE <http://docs.platformio.org/en/latest/ide/eclipse.html>`__
-  (`issue #270 <https://github.com/platformio/platformio/issues/270>`_)
-* Fixed ``AttributeError: 'module' object has no attribute 'packages'``
-  (`issue #252 <https://github.com/platformio/platformio/issues/252>`_)
-
-2.2.2 (2015-07-30)
-~~~~~~~~~~~~~~~~~~
-
-* Integration with `Atom IDE <http://docs.platformio.org/en/latest/ide/atom.html>`__
-* Support for off-line/unpublished/private libraries
-  (`issue #260 <https://github.com/platformio/platformio/issues/260>`_)
-* Disable project auto-clean while building/uploading firmware using
-  `platformio run --disable-auto-clean <http://docs.platformio.org/en/latest/userguide/cmd_run.html#cmdoption--disable-auto-clean>`_ option
-  (`issue #255 <https://github.com/platformio/platformio/issues/255>`_)
-* Show internal errors from "Miniterm" using `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`__ command
-  (`issue #257 <https://github.com/platformio/platformio/issues/257>`_)
-* Fixed `platformio serialports monitor --help <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`__ information with HEX char for hotkeys
-  (`issue #253 <https://github.com/platformio/platformio/issues/253>`_)
-* Handle "OSError: [Errno 13] Permission denied" for PlatformIO installer script
-  (`issue #254 <https://github.com/platformio/platformio/issues/254>`_)
-
-2.2.1 (2015-07-17)
-~~~~~~~~~~~~~~~~~~
-
-* Project generator for `CLion IDE <http://docs.platformio.org/en/latest/ide/clion.html>`__
-  (`issue #132 <https://github.com/platformio/platformio/issues/132>`_)
-* Updated ``tool-bossac`` package to 1.5 version for `atmelsam <http://docs.platformio.org/en/latest/platforms/atmelsam.html>`__ platform
-  (`issue #251 <https://github.com/platformio/platformio/issues/251>`_)
-* Updated ``sdk-esp8266`` package for `espressif <http://docs.platformio.org/en/latest/platforms/espressif.html>`__ platform
-* Fixed incorrect arguments handling for `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ command
-  (`issue #248 <https://github.com/platformio/platformio/issues/248>`_)
-
-2.2.0 (2015-07-01)
-~~~~~~~~~~~~~~~~~~
-
-* Allowed to exclude/include source files from build process using
-  `src_filter <http://docs.platformio.org/en/latest/projectconf.html#src-filter>`__
-  (`issue #240 <https://github.com/platformio/platformio/issues/240>`_)
-* Launch own extra script before firmware building/uploading processes
-  (`issue #239 <https://github.com/platformio/platformio/issues/239>`_)
-* Specify own path to the linker script (ld) using
-  `build_flags <http://docs.platformio.org/en/latest/projectconf.html#build-flags>`__
-  option
-  (`issue #233 <https://github.com/platformio/platformio/issues/233>`_)
-* Specify library compatibility with the all platforms/frameworks
-  using ``*`` symbol in
-  `library.json <http://docs.platformio.org/en/latest/librarymanager/config.html>`__
-* Added support for new embedded boards: *ST 32L0538DISCOVERY and Delta DFCM-NNN40*
-  to `Framework mbed <http://docs.platformio.org/en/latest/frameworks/mbed.html>`__
-* Updated packages for
-  `Framework Arduino (AVR, SAM, Espressif and Teensy cores <http://docs.platformio.org/en/latest/frameworks/arduino.html>`__,
-  `Framework mbed <http://docs.platformio.org/en/latest/frameworks/mbed.html>`__,
-  `Espressif ESP8266 SDK <http://docs.platformio.org/en/latest/platforms/espressif.html>`__
-  (`issue #246 <https://github.com/platformio/platformio/issues/246>`_)
-* Fixed ``stk500v2_command(): command failed``
-  (`issue #238 <https://github.com/platformio/platformio/issues/238>`_)
-* Fixed IDE project generator when board is specified
-  (`issue #242 <https://github.com/platformio/platformio/issues/242>`_)
-* Fixed relative path for includes when generating project for IDE
-  (`issue #243 <https://github.com/platformio/platformio/issues/243>`_)
-* Fixed ESP8266 native SDK exception
-  (`issue #245 <https://github.com/platformio/platformio/issues/245>`_)
-
-2.1.2 (2015-06-21)
-~~~~~~~~~~~~~~~~~~
-
-* Fixed broken link to SCons installer
-
-2.1.1 (2015-06-09)
-~~~~~~~~~~~~~~~~~~
-
-* Automatically detect upload port using VID:PID board settings
-  (`issue #231 <https://github.com/platformio/platformio/issues/231>`_)
-* Improved detection of build changes
-* Avoided ``LibInstallDependencyError`` when more then 1 library is found
-  (`issue #229 <https://github.com/platformio/platformio/issues/229>`_)
-
-2.1.0 (2015-06-03)
-~~~~~~~~~~~~~~~~~~
-
-* Added Silicon Labs EFM32 `siliconlabsefm32 <http://docs.platformio.org/en/latest/platforms/siliconlabsefm32.html>`_
-  development platform
-  (`issue #226 <https://github.com/platformio/platformio/issues/226>`_)
-* Integrate PlatformIO with `Circle CI <https://circleci.com>`_ and
-  `Shippable CI <https://shippable.com>`_
-* Described in documentation how to `create/register own board <http://docs.platformio.org/en/latest/platforms/creating_board.html>`_ for PlatformIO
-* Disabled "nano.specs" for ARM-based platforms
-  (`issue #219 <https://github.com/platformio/platformio/issues/219>`_)
-* Fixed "ConnectionError" when PlatformIO SF Storage is off-line
-* Fixed resolving of C/C++ std libs by Eclipse IDE
-  (`issue #220 <https://github.com/platformio/platformio/issues/220>`_)
-* Fixed firmware uploading using USB programmer (USBasp) for
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html>`_
-  platform
-  (`issue #221 <https://github.com/platformio/platformio/issues/221>`_)
-
-2.0.2 (2015-05-27)
-~~~~~~~~~~~~~~~~~~
-
-* Fixed libraries order for "Library Dependency Finder" under Linux OS
-
-2.0.1 (2015-05-27)
-~~~~~~~~~~~~~~~~~~
-
-* Handle new environment variable
-  `PLATFORMIO_BUILD_FLAGS <http://docs.platformio.org/en/latest/envvars.html#platformio-build-flags>`_
-* Pass to API requests information about Continuous Integration system. This
-  information will be used by PlatformIO-API.
-* Use ``include`` directories from toolchain when initialising project for IDE
-  (`issue #210 <https://github.com/platformio/platformio/issues/210>`_)
-* Added support for new WildFire boards from
-  `Wicked Device <http://wickeddevice.com>`_ to
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
-  platform
-* Updated `Arduino Framework <http://docs.platformio.org/en/latest/frameworks/arduino.html>`__ to
-  1.6.4 version (`issue #212 <https://github.com/platformio/platformio/issues/212>`_)
-* Handle Atmel AVR Symbols when initialising project for IDE
-  (`issue #216 <https://github.com/platformio/platformio/issues/216>`_)
-* Fixed bug with converting ``*.ino`` to ``*.cpp``
-* Fixed failing with ``platformio init --ide eclipse`` without boards
-  (`issue #217 <https://github.com/platformio/platformio/issues/217>`_)
-
-2.0.0 (2015-05-22)
-~~~~~~~~~~~~~~~~~~
-
-*Made in* `Paradise <https://twitter.com/ikravets/status/592356377185619969>`_
-
-* PlatformIO as `Continuous Integration <http://docs.platformio.org/en/latest/ci/index.html>`_
-  (CI) tool for embedded projects
-  (`issue #108 <https://github.com/platformio/platformio/issues/108>`_)
-* Initialise PlatformIO project for the specified IDE
-  (`issue #151 <https://github.com/platformio/platformio/issues/151>`_)
-* PlatformIO CLI 2.0: "platform" related commands have been
-  moved to ``platformio platforms`` subcommand
-  (`issue #158 <https://github.com/platformio/platformio/issues/158>`_)
-* Created `PlatformIO gitter.im <https://gitter.im/platformio/platformio>`_ room
-  (`issue #174 <https://github.com/platformio/platformio/issues/174>`_)
-* Global ``-f, --force`` option which will force to accept any
-  confirmation prompts
-  (`issue #152 <https://github.com/platformio/platformio/issues/152>`_)
-* Run project with `platformio run --project-dir <http://docs.platformio.org/en/latest/userguide/cmd_run.html#cmdoption--project-dir>`_ option without changing the current working
-  directory
-  (`issue #192 <https://github.com/platformio/platformio/issues/192>`_)
-* Control verbosity of `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html#cmdoption-platformio-run-v>`_ command via ``-v/--verbose`` option
-* Add library dependencies for build environment using
-  `lib_install <http://docs.platformio.org/en/latest/projectconf.html#lib-install>`_
-  option in ``platformio.ini``
-  (`issue #134 <https://github.com/platformio/platformio/issues/134>`_)
-* Specify libraries which are compatible with build environment using
-  `lib_use <http://docs.platformio.org/en/latest/projectconf.html#lib-use>`_
-  option in ``platformio.ini``
-  (`issue #148 <https://github.com/platformio/platformio/issues/148>`_)
-* Add more boards to PlatformIO project with
-  `platformio init --board <http://docs.platformio.org/en/latest/userguide/cmd_init.html#cmdoption--board>`__
-  command
-  (`issue #167 <https://github.com/platformio/platformio/issues/167>`_)
-* Choose which library to update
-  (`issue #168 <https://github.com/platformio/platformio/issues/168>`_)
-* Specify `platformio init --env-prefix <http://docs.platformio.org/en/latest/userguide/cmd_init.html#cmdoption--env-prefix>`__ when initialise/update project
-  (`issue #182 <https://github.com/platformio/platformio/issues/182>`_)
-* Added new Armstrap boards
-  (`issue #204 <https://github.com/platformio/platformio/issues/204>`_)
-* Updated SDK for `espressif <http://docs.platformio.org/en/latest/platforms/espressif.html>`__
-  development platform to v1.1
-  (`issue #179 <https://github.com/platformio/platformio/issues/179>`_)
-* Disabled automatic updates by default for platforms, packages and libraries
-  (`issue #171 <https://github.com/platformio/platformio/issues/171>`_)
-* Fixed bug with creating copies of source files
-  (`issue #177 <https://github.com/platformio/platformio/issues/177>`_)
-
-PlatformIO 1.0
---------------
-
-1.5.0 (2015-05-15)
-~~~~~~~~~~~~~~~~~~
-
-* Added support of `Framework mbed <http://platformio.org/#!/frameworks/mbed>`_
-  for Teensy 3.1
-  (`issue #183 <https://github.com/platformio/platformio/issues/183>`_)
-* Added GDB as alternative uploader to `ststm32 <http://docs.platformio.org/en/latest/platforms/ststm32.html>`__ platform
-  (`issue #175 <https://github.com/platformio/platformio/issues/174>`_)
-* Added `examples <https://github.com/platformio/platformio/tree/develop/examples>`__
-  with preconfigured IDE projects
-  (`issue #154 <https://github.com/platformio/platformio/issues/154>`_)
-* Fixed firmware uploading under Linux OS for Arduino Leonardo board
-  (`issue #178 <https://github.com/platformio/platformio/issues/178>`_)
-* Fixed invalid "mbed" firmware for Nucleo F411RE
-  (`issue #185 <https://github.com/platformio/platformio/issues/185>`_)
-* Fixed parsing of includes for PlatformIO Library Dependency Finder
-  (`issue #189 <https://github.com/platformio/platformio/issues/189>`_)
-* Fixed handling symbolic links within source code directory
-  (`issue #190 <https://github.com/platformio/platformio/issues/190>`_)
-* Fixed cancelling any previous definition of name, either built in or provided
-  with a ``-D`` option
-  (`issue #191 <https://github.com/platformio/platformio/issues/191>`_)
-
-1.4.0 (2015-04-11)
-~~~~~~~~~~~~~~~~~~
-
-* Added `espressif <http://docs.platformio.org/en/latest/platforms/espressif.html>`_
-  development platform with ESP01 board
-* Integrated PlatformIO with AppVeyor Windows based Continuous Integration system
-  (`issue #149 <https://github.com/platformio/platformio/issues/149>`_)
-* Added support for Teensy LC board to
-  `teensy <http://docs.platformio.org/en/latest/platforms/teensy.html>`__
-  platform
-* Added support for new Arduino based boards by *SparkFun, BQ, LightUp,
-  LowPowerLab, Quirkbot, RedBearLab, TinyCircuits* to
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
-  platform
-* Upgraded `Arduino Framework <http://docs.platformio.org/en/latest/frameworks/arduino.html>`__ to
-  1.6.3 version (`issue #156 <https://github.com/platformio/platformio/issues/156>`_)
-* Upgraded `Energia Framework <http://docs.platformio.org/en/latest/frameworks/energia.html>`__ to
-  0101E0015 version (`issue #146 <https://github.com/platformio/platformio/issues/146>`_)
-* Upgraded `Arduino Framework with Teensy Core <http://docs.platformio.org/en/latest/frameworks/arduino.html>`_
-  to 1.22 version
-  (`issue #162 <https://github.com/platformio/platformio/issues/162>`_,
-  `issue #170 <https://github.com/platformio/platformio/issues/170>`_)
-* Fixed exceptions with PlatformIO auto-updates when Internet connection isn't
-  active
-
-
-1.3.0 (2015-03-27)
-~~~~~~~~~~~~~~~~~~
-
-* Moved PlatformIO source code and repositories from `Ivan Kravets <https://github.com/ivankravets>`_
-  account to `PlatformIO Organisation <https://github.com/platformio>`_
-  (`issue #138 <https://github.com/platformio/platformio/issues/138>`_)
-* Added support for new Arduino based boards by *SparkFun, RepRap, Sanguino* to
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
-  platform
-  (`issue #127 <https://github.com/platformio/platformio/issues/127>`_,
-  `issue #131 <https://github.com/platformio/platformio/issues/131>`_)
-* Added integration instructions for `Visual Studio <http://docs.platformio.org/en/latest/ide/visualstudio.html>`_
-  and `Sublime Text <http://docs.platformio.org/en/latest/ide/sublimetext.html>`_ IDEs
-* Improved handling of multi-file ``*.ino/pde`` sketches
-  (`issue #130 <https://github.com/platformio/platformio/issues/130>`_)
-* Fixed wrong insertion of function prototypes converting ``*.ino/pde``
-  (`issue #137 <https://github.com/platformio/platformio/issues/137>`_,
-  `issue #140 <https://github.com/platformio/platformio/issues/140>`_)
-
-
-
-1.2.0 (2015-03-20)
-~~~~~~~~~~~~~~~~~~
-
-* Added full support of `mbed <http://docs.platformio.org/en/latest/frameworks/mbed.html>`__
-  framework including libraries: *RTOS, Ethernet, DSP, FAT, USB*.
-* Added `freescalekinetis <http://docs.platformio.org/en/latest/platforms/freescalekinetis.html>`_
-  development platform with Freescale Kinetis Freedom boards
-* Added `nordicnrf51 <http://docs.platformio.org/en/latest/platforms/nordicnrf51.html>`_
-  development platform with supported boards from *JKSoft, Nordic, RedBearLab,
-  Switch Science*
-* Added `nxplpc <http://docs.platformio.org/en/latest/platforms/nxplpc.html>`_
-  development platform with supported boards from *CQ Publishing, Embedded
-  Artists, NGX Technologies, NXP, Outrageous Circuits, SeeedStudio,
-  Solder Splash Labs, Switch Science, u-blox*
-* Added support for *ST Nucleo* boards to
-  `ststm32 <http://docs.platformio.org/en/latest/platforms/ststm32.html>`__
-  development platform
-* Created new `Frameworks <http://docs.platformio.org/en/latest/frameworks/index.html>`__
-  page in documentation and added to `PlatformIO Web Site <http://platformio.org>`_
-  (`issue #115 <https://github.com/platformio/platformio/issues/115>`_)
-* Introduced online `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
-* Automatically append define ``-DPLATFORMIO=%version%`` to
-  builder (`issue #105 <https://github.com/platformio/platformio/issues/105>`_)
-* Renamed ``stm32`` development platform to
-  `ststm32 <http://docs.platformio.org/en/latest/platforms/ststm32.html>`__
-* Renamed ``opencm3`` framework to
-  `libopencm3 <http://docs.platformio.org/en/latest/frameworks/libopencm3.html>`__
-* Fixed uploading for `atmelsam <http://docs.platformio.org/en/latest/platforms/atmelsam.html>`__
-  development platform
-* Fixed re-arranging the ``*.ino/pde`` files when converting to ``*.cpp``
-  (`issue #100 <https://github.com/platformio/platformio/issues/100>`_)
-
-1.1.0 (2015-03-05)
-~~~~~~~~~~~~~~~~~~
-
-* Implemented ``PLATFORMIO_*`` environment variables
-  (`issue #102 <https://github.com/platformio/platformio/issues/102>`_)
-* Added support for *SainSmart* boards to
-  `atmelsam <http://docs.platformio.org/en/latest/platforms/atmelsam.html#boards>`__
-  development platform
-* Added
-  `Project Configuration <http://docs.platformio.org/en/latest/projectconf.html>`__
-  option named `envs_dir <http://docs.platformio.org/en/latest/projectconf.html#envs-dir>`__
-* Disabled "prompts" automatically for *Continuous Integration* systems
-  (`issue #103 <https://github.com/platformio/platformio/issues/103>`_)
-* Fixed firmware uploading for
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
-  boards which work within ``usbtiny`` protocol
-* Fixed uploading for *Digispark* board (`issue #106 <https://github.com/platformio/platformio/issues/106>`_)
-
-1.0.1 (2015-02-27)
-~~~~~~~~~~~~~~~~~~
-
-**PlatformIO 1.0 - recommended for production**
-
-* Changed development status from ``beta`` to ``Production/Stable``
-* Added support for *ARM*-based credit-card sized computers:
-  `Raspberry Pi <http://www.raspberrypi.org>`_,
-  `BeagleBone <http://beagleboard.org>`_ and `CubieBoard <http://cubieboard.org>`_
-* Added `atmelsam <http://docs.platformio.org/en/latest/platforms/atmelsam.html>`__
-  development platform with supported boards: *Arduino Due and Digistump DigiX*
-  (`issue #71 <https://github.com/platformio/platformio/issues/71>`_)
-* Added `ststm32 <http://docs.platformio.org/en/latest/platforms/ststm32.html>`__
-  development platform with supported boards: *Discovery kit for STM32L151/152,
-  STM32F303xx, STM32F407/417 lines* and `libOpenCM3 Framework <http://www.libopencm3.org>`_
-  (`issue #73 <https://github.com/platformio/platformio/issues/73>`_)
-* Added `teensy <http://docs.platformio.org/en/latest/platforms/teensy.html>`_
-  development platform with supported boards: *Teensy 2.x & 3.x*
-  (`issue #72 <https://github.com/platformio/platformio/issues/72>`_)
-* Added new *Arduino* boards to
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
-  platform: *Arduino NG, Arduino BT, Arduino Esplora, Arduino Ethernet,
-  Arduino Robot Control, Arduino Robot Motor and Arduino Yun*
-* Added support for *Adafruit* boards to
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
-  platform: *Adafruit Flora and Adafruit Trinkets*
-  (`issue #65 <https://github.com/platformio/platformio/issues/65>`_)
-* Added support for *Digispark* boards to
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
-  platform: *Digispark USB Development Board and Digispark Pro*
-  (`issue #47 <https://github.com/platformio/platformio/issues/47>`_)
-* Covered code with tests (`issue #2 <https://github.com/platformio/platformio/issues/2>`_)
-* Refactored *Library Dependency Finder* (issues
-  `#48 <https://github.com/platformio/platformio/issues/48>`_,
-  `#50 <https://github.com/platformio/platformio/issues/50>`_,
-  `#55 <https://github.com/platformio/platformio/pull/55>`_)
-* Added `src_dir <http://docs.platformio.org/en/latest/projectconf.html#src-dir>`__
-  option to ``[platformio]`` section of
-  `platformio.ini <http://docs.platformio.org/en/latest/projectconf.html>`__
-  which allows to redefine location to project's source directory
-  (`issue #83 <https://github.com/platformio/platformio/issues/83>`_)
-* Added ``--json-output`` option to
-  `platformio boards <http://docs.platformio.org/en/latest/userguide/cmd_boards.html>`__
-  and `platformio search <http://docs.platformio.org/en/latest/userguide/cmd_search.html>`__
-  commands which allows to return the output in `JSON <http://en.wikipedia.org/wiki/JSON>`_ format
-  (`issue #42 <https://github.com/platformio/platformio/issues/42>`_)
-* Allowed to ignore some libs from *Library Dependency Finder* via
-  `lib_ignore <http://docs.platformio.org/en/latest/projectconf.html#lib-ignore>`_ option
-* Improved `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
-  command: asynchronous output for build process, timing and detailed
-  information about environment configuration
-  (`issue #74 <https://github.com/platformio/platformio/issues/74>`_)
-* Output compiled size and static memory usage with
-  `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
-  command (`issue #59 <https://github.com/platformio/platformio/issues/59>`_)
-* Updated `framework-arduino` AVR & SAM to 1.6 stable version
-* Fixed an issue with the libraries that are git repositories
-  (`issue #49 <https://github.com/platformio/platformio/issues/49>`_)
-* Fixed handling of assembly files
-  (`issue #58 <https://github.com/platformio/platformio/issues/58>`_)
-* Fixed compiling error if space is in user's folder
-  (`issue #56 <https://github.com/platformio/platformio/issues/56>`_)
-* Fixed `AttributeError: 'module' object has no attribute 'disable_warnings'`
-  when a version of `requests` package is less then 2.4.0
-* Fixed bug with invalid process's "return code" when PlatformIO has internal
-  error (`issue #81 <https://github.com/platformio/platformio/issues/81>`_)
-* Several bug fixes, increased stability and performance improvements
-
-PlatformIO 0.0
---------------
-
-0.10.2 (2015-01-06)
+6.1.16 (2024-09-26)
 ~~~~~~~~~~~~~~~~~~~
 
-* Fixed an issue with ``--json-output``
-  (`issue #42 <https://github.com/platformio/platformio/issues/42>`_)
-* Fixed an exception during
-  `platformio upgrade <http://docs.platformio.org/en/latest/userguide/cmd_upgrade.html>`__
-  under Windows OS (`issue #45 <https://github.com/platformio/platformio/issues/45>`_)
+* Added support for Python 3.13
+* Introduced the `PLATFORMIO_SYSTEM_TYPE <https://docs.platformio.org/en/latest/envvars.html#envvar-PLATFORMIO_SYSTEM_TYPE>`__ environment variable, enabling manual override of the detected system type for greater flexibility and control in custom build environments
+* Enhanced internet connection checks by falling back to HTTPS protocol when HTTP (port 80) fails (`issue #4980 <https://github.com/platformio/platformio-core/issues/4980>`_)
+* Upgraded the build engine to the latest version of SCons (4.8.1) to improve build performance, reliability, and compatibility with other tools and systems (`release notes <https://github.com/SCons/scons/releases/tag/4.8.1>`__)
+* Upgraded the `Doctest <https://docs.platformio.org/en/latest/advanced/unit-testing/frameworks/doctest.html>`__ testing framework to version 2.4.11, the `GoogleTest <https://docs.platformio.org/en/latest/advanced/unit-testing/frameworks/doctest.html>`__ to version 1.15.2, and the `Unity <https://docs.platformio.org/en/latest/advanced/unit-testing/frameworks/unity.html>`__ to version 2.6.0, incorporating the latest features and improvements for enhanced testing capabilities
+* Corrected an issue where the incorrect public class was imported for the ``DoctestTestRunner`` (`issue #4949 <https://github.com/platformio/platformio-core/issues/4949>`_)
 
-0.10.1 (2015-01-02)
+6.1.15 (2024-04-25)
 ~~~~~~~~~~~~~~~~~~~
 
-* Added ``--json-output`` option to
-  `platformio list <http://docs.platformio.org/en/latest/userguide/cmd_list.html>`__,
-  `platformio serialports list <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html>`__ and
-  `platformio lib list <http://docs.platformio.org/en/latest/userguide/lib/cmd_list.html>`__
-  commands which allows to return the output in `JSON <http://en.wikipedia.org/wiki/JSON>`_ format
-  (`issue #42 <https://github.com/platformio/platformio/issues/42>`_)
-* Fixed missing auto-uploading by default after `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`__
-  command
+* Resolved an issue where the |LDF| couldn't locate a library dependency declared via version control system repository (`issue #4885 <https://github.com/platformio/platformio-core/issues/4885>`_)
+* Resolved an issue related to the inaccurate detection of the Clang compiler (`pull #4897 <https://github.com/platformio/platformio-core/pull/4897>`_)
 
-0.10.0 (2015-01-01)
+6.1.14 (2024-03-21)
 ~~~~~~~~~~~~~~~~~~~
 
-**Happy New Year!**
+* Introduced the ``--json-output`` option to the `pio test <https://docs.platformio.org/en/latest/core/userguide/cmd_test.html>`__ command, enabling users to generate test results in the JSON format
+* Upgraded the build engine to the latest version of SCons (4.7.0) to improve build performance, reliability, and compatibility with other tools and systems (`release notes <https://github.com/SCons/scons/releases/tag/4.7.0>`__)
+* Broadened version support for the ``pyelftools`` dependency, enabling compatibility with lower versions and facilitating integration with a wider range of third-party tools (`issue #4834 <https://github.com/platformio/platformio-core/issues/4834>`_)
+* Addressed an issue where passing a relative path (``--project-dir``) to the `pio project init <https://docs.platformio.org/en/latest/core/userguide/project/cmd_init.html>`__ command resulted in an error (`issue #4847 <https://github.com/platformio/platformio-core/issues/4847>`_)
+* Enhanced |STATICCODEANALYSIS| to accommodate scenarios where custom ``src_dir`` or ``include_dir`` are located outside the project folder (`pull #4874 <https://github.com/platformio/platformio-core/pull/4874>`_)
+* Corrected the validation of ``symlink://`` `package specifications <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_install.html#local-folder>`__ , resolving an issue that caused the package manager to repeatedly reinstall dependencies (`pull #4870 <https://github.com/platformio/platformio-core/pull/4870>`_)
+* Resolved an issue related to the relative package path in the `pio pkg publish <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_publish.html>`__ command
+* Resolved an issue where the |LDF| selected an incorrect library version (`issue #4860 <https://github.com/platformio/platformio-core/issues/4860>`_)
+* Resolved an issue with the ``hexlify`` filter in the `device monitor <https://docs.platformio.org/en/latest/core/userguide/device/cmd_monitor.html>`__ command, ensuring proper representation of characters with Unicode code points higher than 127 (`issue #4732 <https://github.com/platformio/platformio-core/issues/4732>`_)
 
-* Implemented `platformio boards <http://docs.platformio.org/en/latest/userguide/cmd_boards.html>`_
-  command (`issue #11 <https://github.com/platformio/platformio/issues/11>`_)
-* Added support of *Engduino* boards for
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#engduino>`__
-  platform (`issue #38 <https://github.com/platformio/platformio/issues/38>`_)
-* Added ``--board`` option to `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`__
-  command which allows to initialise project with the specified embedded boards
-  (`issue #21 <https://github.com/platformio/platformio/issues/21>`_)
-* Added `example with uploading firmware <http://docs.platformio.org/en/latest/projectconf.html#examples>`_
-  via USB programmer (USBasp) for
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html>`_
-  *MCUs* (`issue #35 <https://github.com/platformio/platformio/issues/35>`_)
-* Automatic detection of port on `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_
-  (`issue #37 <https://github.com/platformio/platformio/issues/37>`_)
-* Allowed auto-installation of platforms when prompts are disabled (`issue #43 <https://github.com/platformio/platformio/issues/43>`_)
-* Fixed urllib3's *SSL* warning under Python <= 2.7.2 (`issue #39 <https://github.com/platformio/platformio/issues/39>`_)
-* Fixed bug with *Arduino USB* boards (`issue #40 <https://github.com/platformio/platformio/issues/40>`_)
+6.1.13 (2024-01-12)
+~~~~~~~~~~~~~~~~~~~
 
-0.9.2 (2014-12-10)
+* Expanded support for SCons variables declared in the legacy format ``${SCONS_VARNAME}`` (`issue #4828 <https://github.com/platformio/platformio-core/issues/4828>`_)
+
+6.1.12 (2024-01-10)
+~~~~~~~~~~~~~~~~~~~
+
+* Added support for Python 3.12
+* Introduced the capability to launch the debug server in a separate process (`issue #4722 <https://github.com/platformio/platformio-core/issues/4722>`_)
+* Introduced a warning during the verification of MCU maximum RAM usage, signaling when the allocated RAM surpasses 100% (`issue #4791 <https://github.com/platformio/platformio-core/issues/4791>`_)
+* Drastically enhanced the speed of project building when operating in verbose mode (`issue #4783 <https://github.com/platformio/platformio-core/issues/4783>`_)
+* Upgraded the build engine to the latest version of SCons (4.6.0) to improve build performance, reliability, and compatibility with other tools and systems (`release notes <https://github.com/SCons/scons/releases/tag/4.6.0>`__)
+* Enhanced the handling of built-in variables in |PIOCONF| during |INTERPOLATION| (`issue #4695 <https://github.com/platformio/platformio-core/issues/4695>`_)
+* Enhanced PIP dependency declarations for improved reliability and extended support to include Python 3.6 (`issue #4819 <https://github.com/platformio/platformio-core/issues/4819>`_)
+* Implemented automatic installation of missing dependencies when utilizing a SOCKS proxy (`issue #4822 <https://github.com/platformio/platformio-core/issues/4822>`_)
+* Implemented a fail-safe mechanism to terminate a debugging session if an unknown CLI option is passed (`issue #4699 <https://github.com/platformio/platformio-core/issues/4699>`_)
+* Rectified an issue where ``${platformio.name}`` erroneously represented ``None`` as the default `project name <https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/generic/name.html>`__ (`issue #4717 <https://github.com/platformio/platformio-core/issues/4717>`_)
+* Resolved an issue where the ``COMPILATIONDB_INCLUDE_TOOLCHAIN`` setting was not correctly applying to private libraries (`issue #4762 <https://github.com/platformio/platformio-core/issues/4762>`_)
+* Resolved an issue where ``get_systype()`` inaccurately returned the architecture when executed within a Docker container on a 64-bit kernel with a 32-bit userspace (`issue #4777 <https://github.com/platformio/platformio-core/issues/4777>`_)
+* Resolved an issue with incorrect handling of the ``check_src_filters`` option when used in multiple environments (`issue #4788 <https://github.com/platformio/platformio-core/issues/4788>`_)
+* Resolved an issue where running `pio project metadata <https://docs.platformio.org/en/latest/core/userguide/project/cmd_metadata.html>`__ resulted in duplicated "include" entries (`issue #4723 <https://github.com/platformio/platformio-core/issues/4723>`_)
+* Resolved an issue where native debugging failed on the host machine (`issue #4745 <https://github.com/platformio/platformio-core/issues/4745>`_)
+* Resolved an issue where custom debug configurations were being inadvertently overwritten in VSCode's ``launch.json`` (`issue #4810 <https://github.com/platformio/platformio-core/issues/4810>`_)
+
+6.1.11 (2023-08-31)
+~~~~~~~~~~~~~~~~~~~
+
+* Resolved a possible issue that may cause generated projects for `PlatformIO IDE for VSCode <https://docs.platformio.org/en/latest/integration/ide/vscode.html>`__ to fail to launch a debug session because of a missing "objdump" binary when GDB is not part of the toolchain package
+* Resolved a regression issue that resulted in the malfunction of the Memory Inspection feature within `PIO Home <https://docs.platformio.org/en/latest/home/index.html>`__
+
+6.1.10 (2023-08-11)
+~~~~~~~~~~~~~~~~~~~
+
+* Resolved an issue that caused generated projects for `PlatformIO IDE for VSCode <https://docs.platformio.org/en/latest/integration/ide/vscode.html>`__ to break when the ``-iprefix`` compiler flag was used
+* Resolved an issue encountered while utilizing the `pio pkg exec <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_exec.html>`__ command on the Windows platform to execute Python scripts from a package
+* Implemented a crucial improvement to the `pio run <https://docs.platformio.org/en/latest/core/userguide/cmd_run.html>`__ command, guaranteeing that the ``monitor`` target is not executed if any of the preceding targets, such as ``upload``, encounter failures
+* `Cppcheck <https://docs.platformio.org/en/latest/plus/check-tools/cppcheck.html>`__ v2.11 with new checks, CLI commands and various analysis improvements
+* Resolved a critical issue that arose on macOS ARM platforms due to the Python "requests" module, leading to a "ModuleNotFoundError: No module named 'chardet'" (`issue #4702 <https://github.com/platformio/platformio-core/issues/4702>`_)
+
+6.1.9 (2023-07-06)
 ~~~~~~~~~~~~~~~~~~
 
-* Replaced "dark blue" by "cyan" colour for the texts (`issue #33 <https://github.com/platformio/platformio/issues/33>`_)
-* Added new setting `enable_prompts <http://docs.platformio.org/en/latest/userguide/cmd_settings.html>`_
-  and allowed to disable all *PlatformIO* prompts (useful for cloud compilers)
-  (`issue #34 <https://github.com/platformio/platformio/issues/34>`_)
-* Fixed compilation bug on *Windows* with installed *MSVC* (`issue #18 <https://github.com/platformio/platformio/issues/18>`_)
+* Rectified a regression bug that occurred when the ``-include`` flag was passed via the `build_flags <https://docs.platformio.org/en/latest/projectconf/sections/env/options/build/build_flags.html>`__ option as a relative path and subsequently expanded (`issue #4683 <https://github.com/platformio/platformio-core/issues/4683>`_)
+* Resolved an issue that resulted in unresolved absolute toolchain paths when generating the `Compilation database "compile_commands.json" <https://docs.platformio.org/en/latest/integration/compile_commands.html>`__ (`issue #4684 <https://github.com/platformio/platformio-core/issues/4684>`_)
 
-0.9.1 (2014-12-05)
+6.1.8 (2023-07-05)
 ~~~~~~~~~~~~~~~~~~
 
-* Ask user to install platform (when it hasn't been installed yet) within
-  `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
-  and `platformio show <http://docs.platformio.org/en/latest/userguide/cmd_show.html>`_ commands
-* Improved main `documentation <http://docs.platformio.org>`_
-* Fixed "*OSError: [Errno 2] No such file or directory*" within
-  `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
-  command when PlatformIO isn't installed properly
-* Fixed example for `Eclipse IDE with Tiva board <https://github.com/platformio/platformio/tree/develop/examples/ide/eclipse>`_
-  (`issue #32 <https://github.com/platformio/platformio/pull/32>`_)
-* Upgraded `Eclipse Project Examples <https://github.com/platformio/platformio/tree/develop/examples/ide/eclipse>`_
-  to latest *Luna* and *PlatformIO* releases
+* Added a new ``--lint`` option to the `pio project config <https://docs.platformio.org/en/latest/core/userguide/project/cmd_config.html>`__ command, enabling users to efficiently perform linting on the |PIOCONF|
+* Enhanced the parsing of the |PIOCONF| to provide comprehensive diagnostic information
+* Expanded the functionality of the |LIBRARYJSON| manifest by allowing the use of the underscore symbol in the `keywords <https://docs.platformio.org/en/latest/manifests/library-json/fields/keywords.html>`__ field
+* Optimized project integration templates to address the issue of long paths on Windows (`issue #4652 <https://github.com/platformio/platformio-core/issues/4652>`_)
+* Refactored |UNITTESTING| engine to resolve compiler warnings with "-Wpedantic" option (`pull #4671 <https://github.com/platformio/platformio-core/pull/4671>`_)
+* Eliminated erroneous warning regarding the use of obsolete PlatformIO Core when downgrading to the stable version (`issue #4664 <https://github.com/platformio/platformio-core/issues/4664>`_)
+* Updated the `pio project metadata <https://docs.platformio.org/en/latest/core/userguide/project/cmd_metadata.html>`__ command to return C/C++ flags as parsed Unix shell arguments when dumping project build metadata
+* Resolved a critical issue related to the usage of the ``-include`` flag within the `build_flags <https://docs.platformio.org/en/latest/projectconf/sections/env/options/build/build_flags.html>`__ option, specifically when employing dynamic variables (`issue #4682 <https://github.com/platformio/platformio-core/issues/4682>`_)
+* Removed PlatformIO IDE for Atom from the documentation as `Atom has been deprecated <https://github.blog/2022-06-08-sunsetting-atom/>`__
 
-0.9.0 (2014-12-01)
+6.1.7 (2023-05-08)
 ~~~~~~~~~~~~~~~~~~
 
-* Implemented `platformio settings <http://docs.platformio.org/en/latest/userguide/cmd_settings.html>`_ command
-* Improved `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`_ command.
-  Added new option ``--project-dir`` where you can specify another path to
-  directory where new project will be initialized (`issue #31 <https://github.com/platformio/platformio/issues/31>`_)
-* Added *Migration Manager* which simplifies process with upgrading to a
-  major release
-* Added *Telemetry Service* which should help us make *PlatformIO* better
-* Implemented *PlatformIO AppState Manager* which allow to have multiple
-  ``.platformio`` states.
-* Refactored *Package Manager*
-* Download Manager: fixed SHA1 verification within *Cygwin Environment*
-  (`issue #26 <https://github.com/platformio/platformio/issues/26>`_)
-* Fixed bug with code builder and built-in Arduino libraries
-  (`issue #28 <https://github.com/platformio/platformio/issues/28>`_)
+* Introduced a new ``--sample-code`` option to the `pio project init <https://docs.platformio.org/en/latest/core/userguide/project/cmd_init.html>`__ command, which allows users to include sample code in the newly created project
+* Added validation for `project working environment names <https://docs.platformio.org/en/latest/projectconf/sections/env/index.html#working-env-name>`__ to ensure that they only contain lowercase letters ``a-z``, numbers ``0-9``, and special characters ``_`` (underscore) and ``-`` (hyphen)
+* Added the ability to show a detailed library dependency tree only in `verbose mode <https://docs.platformio.org/en/latest/core/userguide/cmd_run.html#cmdoption-pio-run-v>`__, which can help you understand the relationship between libraries and troubleshoot issues more effectively (`issue #4517 <https://github.com/platformio/platformio-core/issues/4517>`_)
+* Added the ability to run only the `device monitor <https://docs.platformio.org/en/latest/core/userguide/device/cmd_monitor.html>`__ when using the `pio run -t monitor <https://docs.platformio.org/en/latest/core/userguide/cmd_run.html>`__ command, saving you time and resources by skipping the build process
+* Implemented a new feature to store device monitor logs in the project's ``logs`` folder, making it easier to access and review device monitor logs for your projects (`issue #4596 <https://github.com/platformio/platformio-core/issues/4596>`_)
+* Improved support for projects located on Windows network drives, including Network Shared Folder, Dropbox, OneDrive, Google Drive, and other similar services (`issue #3417 <https://github.com/platformio/platformio-core/issues/3417>`_)
+* Improved source file filtering functionality for the `Static Code Analysis <https://docs.platformio.org/en/latest/advanced/static-code-analysis/index.html>`__ feature, making it easier to analyze only the code you need to
+* Upgraded the build engine to the latest version of SCons (4.5.2) to improve build performance, reliability, and compatibility with other tools and systems (`release notes <https://github.com/SCons/scons/releases/tag/4.5.2>`__)
+* Implemented a fix for shell injection vulnerabilities when converting INO files to CPP, ensuring your code is safe and secure (`issue #4532 <https://github.com/platformio/platformio-core/issues/4532>`_)
+* Restored the project generator for the `NetBeans IDE <https://docs.platformio.org/en/latest/integration/ide/netbeans.html>`__, providing you with more flexibility and options for your development workflow
+* Resolved installation issues with PIO Remote on Raspberry Pi and other small form-factor PCs (`issue #4425 <https://github.com/platformio/platformio-core/issues/4425>`_, `issue #4493 <https://github.com/platformio/platformio-core/issues/4493>`_, `issue #4607 <https://github.com/platformio/platformio-core/issues/4607>`_)
+* Resolved an issue where the `build_cache_dir <https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/build_cache_dir.html>`__ setting was not being recognized consistently across multiple environments (`issue #4574 <https://github.com/platformio/platformio-core/issues/4574>`_)
+* Resolved an issue where organization details could not be updated using the `pio org update <https://docs.platformio.org/en/latest/core/userguide/org/cmd_update.html>`__ command
+* Resolved an issue where the incorrect debugging environment was generated for VSCode in "Auto" mode (`issue #4597 <https://github.com/platformio/platformio-core/issues/4597>`_)
+* Resolved an issue where native tests would fail if a custom program name was specified (`issue #4546 <https://github.com/platformio/platformio-core/issues/4546>`_)
+* Resolved an issue where the PlatformIO |DEBUGGING| solution was not escaping the tool installation process into MI2 correctly (`issue #4565 <https://github.com/platformio/platformio-core/issues/4565>`_)
+* Resolved an issue where multiple targets were not executed sequentially (`issue #4604 <https://github.com/platformio/platformio-core/issues/4604>`_)
+* Resolved an issue where upgrading PlatformIO Core fails on Windows with Python 3.11 (`issue #4540 <https://github.com/platformio/platformio-core/issues/4540>`_)
 
-0.8.0 (2014-10-19)
+6.1.6 (2023-01-23)
 ~~~~~~~~~~~~~~~~~~
 
-* Avoided trademark issues in `library.json <http://docs.platformio.org/en/latest/librarymanager/config.html>`_
-  with the new fields: `frameworks <http://docs.platformio.org/en/latest/librarymanager/config.html#frameworks>`_,
-  `platforms <http://docs.platformio.org/en/latest/librarymanager/config.html#platforms>`_
-  and `dependencies <http://docs.platformio.org/en/latest/librarymanager/config.html#dependencies>`_
-  (`issue #17 <https://github.com/platformio/platformio/issues/17>`_)
-* Switched logic from "Library Name" to "Library Registry ID" for all
-  `platformio lib <http://docs.platformio.org/en/latest/userguide/lib/index.html>`_
-  commands (install, uninstall, update and etc.)
-* Renamed ``author`` field to `authors <http://docs.platformio.org/en/latest/librarymanager/config.html#authors>`_
-  and allowed to setup multiple authors per library in `library.json <http://docs.platformio.org/en/latest/librarymanager/config.html>`_
-* Added option to specify "maintainer" status in `authors <http://docs.platformio.org/en/latest/librarymanager/config.html#authors>`_ field
-* New filters/options for `platformio lib search <http://docs.platformio.org/en/latest/userguide/lib/cmd_search.html>`_
-  command: ``--framework`` and ``--platform``
+* Added support for Python 3.11
+* Added a new `name <https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/generic/description.html>`__ configuration option to customize a project name (`pull #4498 <https://github.com/platformio/platformio-core/pull/4498>`_)
+* Made assets (templates, ``99-platformio-udev.rules``) part of Python's module (`issue #4458 <https://github.com/platformio/platformio-core/issues/4458>`_)
+* Updated `Clang-Tidy <https://docs.platformio.org/en/latest/plus/check-tools/clang-tidy.html>`__ check tool to v15.0.5 with new diagnostics and bugfixes
+* Removed dependency on the "zeroconf" package and install it only when a user lists mDNS devices (issue with zeroconf's LGPL license)
+* Show the real error message instead of "Can not remove temporary directory" when |PIOCONF| is broken (`issue #4480 <https://github.com/platformio/platformio-core/issues/4480>`_)
+* Fixed an issue with an incorrect test summary when a testcase name includes a colon (`issue #4508 <https://github.com/platformio/platformio-core/issues/4508>`_)
+* Fixed an issue when `extends <https://docs.platformio.org/en/latest/projectconf/sections/env/options/advanced/extends.html>`__ did not override options in the right order (`issue #4462 <https://github.com/platformio/platformio-core/issues/4462>`_)
+* Fixed an issue when `pio pkg list <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_list.html>`__ and `pio pkg uninstall <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_uninstall.html>`__ commands fail if there are circular dependencies in the |LIBRARYJSON| manifests (`issue #4475 <https://github.com/platformio/platformio-core/issues/4475>`_)
 
-0.7.1 (2014-10-06)
+6.1.5 (2022-11-01)
 ~~~~~~~~~~~~~~~~~~
 
-* Fixed bug with order for includes in conversation from INO/PDE to CPP
-* Automatic detection of port on upload (`issue #15 <https://github.com/platformio/platformio/issues/15>`_)
-* Fixed lib update crashing when no libs are installed (`issue #19 <https://github.com/platformio/platformio/issues/19>`_)
+* Added a new `enable_proxy_strict_ssl <https://docs.platformio.org/en/latest/core/userguide/cmd_settings.html>`__ setting to disable the proxy server certificate verification (`issue #4432 <https://github.com/platformio/platformio-core/issues/4432>`_)
+* Documented `PlatformIO Core Proxy Configuration <https://docs.platformio.org/en/latest/core/installation/proxy-configuration.html>`__
+* Speeded up device port finder by avoiding loading board HWIDs from development platforms
+* Improved caching of build metadata in debug mode
+* Fixed an issue when `pio pkg install --storage-dir <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_install.html>`__ command requires PlatformIO project (`issue #4410 <https://github.com/platformio/platformio-core/issues/4410>`_)
 
-
-0.7.0 (2014-09-24)
+6.1.4 (2022-08-12)
 ~~~~~~~~~~~~~~~~~~
 
-* Implemented new `[platformio] <http://docs.platformio.org/en/latest/projectconf.html#platformio>`_
-  section for Configuration File with `home_dir <http://docs.platformio.org/en/latest/projectconf.html#home-dir>`_
-  option (`issue #14 <https://github.com/platformio/platformio/issues/14>`_)
-* Implemented *Library Manager* (`issue #6 <https://github.com/platformio/platformio/issues/6>`_)
+* Added support for accepting the original FileNode environment in a "callback" function when using `Build Middlewares <https://docs.platformio.org/en/latest/scripting/middlewares.html>`__ (`pull #4380 <https://github.com/platformio/platformio-core/pull/4380>`_)
+* Improved device port finder when using dual channel UART converter (`issue #4367 <https://github.com/platformio/platformio-core/issues/4367>`_)
+* Improved project dependency resolving when using the `pio project init --ide <https://docs.platformio.org/en/latest/core/userguide/project/cmd_init.html>`__ command
+* Upgraded build engine to the SCons 4.4.0 (`release notes <https://github.com/SCons/scons/releases/tag/4.4.0>`__)
+* Keep custom "unwantedRecommendations" when generating projects for VSCode (`issue #4383 <https://github.com/platformio/platformio-core/issues/4383>`_)
+* Do not resolve project dependencies for the ``cleanall`` target (`issue #4344 <https://github.com/platformio/platformio-core/issues/4344>`_)
+* Warn about calling "env.BuildSources" in a POST-type script (`issue #4385 <https://github.com/platformio/platformio-core/issues/4385>`_)
+* Fixed an issue when escaping macros/defines for IDE integration (`issue #4360 <https://github.com/platformio/platformio-core/issues/4360>`_)
+* Fixed an issue when the "cleanall" target removes dependencies from all working environments (`issue #4386 <https://github.com/platformio/platformio-core/issues/4386>`_)
 
-0.6.0 (2014-08-09)
+6.1.3 (2022-07-18)
 ~~~~~~~~~~~~~~~~~~
 
-* Implemented `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ (`issue #10 <https://github.com/platformio/platformio/issues/10>`_)
-* Fixed an issue ``ImportError: No module named platformio.util`` (`issue #9 <https://github.com/platformio/platformio/issues/9>`_)
-* Fixed bug with auto-conversation from Arduino \*.ino to \*.cpp
+* Fixed a regression bug when opening device monitor without any filters (`issue #4363 <https://github.com/platformio/platformio-core/issues/4363>`_)
 
-0.5.0 (2014-08-04)
+6.1.2 (2022-07-18)
 ~~~~~~~~~~~~~~~~~~
 
-* Improved nested lookups for libraries
-* Disabled default warning flag "-Wall"
-* Added auto-conversation from \*.ino to valid \*.cpp for Arduino/Energia
-  frameworks (`issue #7 <https://github.com/platformio/platformio/issues/7>`_)
-* Added `Arduino example <https://github.com/platformio/platformio/tree/develop/examples/>`_
-  with external library (*Adafruit CC3000*)
-* Implemented `platformio upgrade <http://docs.platformio.org/en/latest/userguide/cmd_upgrade.html>`_
-  command and "auto-check" for the latest
-  version (`issue #8 <https://github.com/platformio/platformio/issues/8>`_)
-* Fixed an issue with "auto-reset" for *Raspduino* board
-* Fixed a bug with nested libs building
+* Export a ``PIO_UNIT_TESTING`` macro to the project source files and dependent libraries in the |UNITTESTING| mode
+* Improved detection of Windows architecture (`issue #4353 <https://github.com/platformio/platformio-core/issues/4353>`_)
+* Warn about unknown `device monitor filters <https://docs.platformio.org/en/latest/core/userguide/device/cmd_monitor.html#filters>`__ (`issue #4362 <https://github.com/platformio/platformio-core/issues/4362>`_)
+* Fixed a regression bug when `libArchive <https://docs.platformio.org/en/latest/manifests/library-json/fields/build/libarchive.html>`__ option declared in the |LIBRARYJSON| manifest was ignored (`issue #4351 <https://github.com/platformio/platformio-core/issues/4351>`_)
+* Fixed an issue when the `pio pkg publish <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_publish.html>`__ command didn't work with Python 3.6 (`issue #4352 <https://github.com/platformio/platformio-core/issues/4352>`_)
 
-0.4.0 (2014-07-31)
+6.1.1 (2022-07-11)
 ~~~~~~~~~~~~~~~~~~
 
-* Implemented `platformio serialports <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html>`_ command
-* Allowed to put special build flags only for ``src`` files via
-  `src_build_flags <http://docs.platformio.org/en/latest/projectconf.html#src_build-flags>`_
-  environment option
-* Allowed to override some of settings via system environment variables
-  such as: ``PLATFORMIO_SRC_BUILD_FLAGS`` and ``PLATFORMIO_ENVS_DIR``
-* Added ``--upload-port`` option for `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html#cmdoption--upload-port>`__ command
-* Implemented (especially for `SmartAnthill <http://docs.smartanthill.ikravets.com/>`_)
-  `platformio run -t uploadlazy <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`_
-  target (no dependencies to framework libs, ELF and etc.)
-* Allowed to skip default packages via `platformio install --skip-default-package <http://docs.platformio.org/en/latest/userguide/cmd_install.html#cmdoption--skip-default>`_
-  option
-* Added tools for *Raspberry Pi* platform
-* Added support for *Microduino* and *Raspduino* boards in
-  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html>`_ platform
+* Added new ``monitor_encoding`` project configuration option to configure `Device Monitor <https://docs.platformio.org/en/latest/core/userguide/device/cmd_monitor.html>`__ (`issue #4350 <https://github.com/platformio/platformio-core/issues/4350>`_)
+* Allowed specifying project environments for `pio ci <https://docs.platformio.org/en/latest/core/userguide/cmd_ci.html>`__ command (`issue #4347 <https://github.com/platformio/platformio-core/issues/4347>`_)
+* Show "TimeoutError" only in the verbose mode when can not find a serial port
+* Fixed an issue when a serial port was not automatically detected if the board has predefined HWIDs
+* Fixed an issue with endless scanning of project dependencies (`issue #4349 <https://github.com/platformio/platformio-core/issues/4349>`_)
+* Fixed an issue with |LDF| when incompatible libraries were used for the working project environment with the missed framework (`pull #4346 <https://github.com/platformio/platformio-core/pull/4346>`_)
 
-
-0.3.1 (2014-06-21)
+6.1.0 (2022-07-06)
 ~~~~~~~~~~~~~~~~~~
 
-* Fixed auto-installer for Windows OS (bug with %PATH% customisations)
+* **Device Manager**
 
+  - Automatically reconnect device monitor if a connection fails
+  - Added new `pio device monitor --no-reconnect <https://docs.platformio.org/en/latest/core/userguide/device/cmd_monitor.html#cmdoption-pio-device-monitor-no-reconnect>`__ option to disable automatic reconnection
+  - Handle device monitor disconnects more gracefully (`issue #3939 <https://github.com/platformio/platformio-core/issues/3939>`_)
+  - Improved a serial port finder for `Black Magic Probe <https://docs.platformio.org/en/latest/plus/debug-tools/blackmagic.html>`__ (`issue #4023 <https://github.com/platformio/platformio-core/issues/4023>`_)
+  - Improved a serial port finder for a board with predefined HWIDs
+  - Replaced ``monitor_flags`` with independent project configuration options: `monitor_parity <https://docs.platformio.org/en/latest/projectconf/section_env_monitor.html#monitor-parity>`__, `monitor_eol <https://docs.platformio.org/en/latest/projectconf/section_env_monitor.html#monitor-eol>`__, `monitor_raw <https://docs.platformio.org/en/latest/projectconf/section_env_monitor.html#monitor-raw>`__, `monitor_echo <https://docs.platformio.org/en/latest/projectconf/section_env_monitor.html#monitor-echo>`__
+  - Fixed an issue when the monitor filters were not applied in their order (`issue #4320 <https://github.com/platformio/platformio-core/issues/4320>`_)
 
-0.3.0 (2014-06-21)
+* **Unit Testing**
+
+  - Updated "Getting Started" documentation for `GoogleTest <https://docs.platformio.org/en/latest/advanced/unit-testing/frameworks/googletest.html>`__ testing and mocking framework
+  - Export |UNITTESTING| flags only to the project build environment (``projenv``, files in "src" folder)
+  - Merged the "building" stage with "uploading" for the embedded target (`issue #4307 <https://github.com/platformio/platformio-core/issues/4307>`_)
+  - Do not resolve dependencies from the project "src" folder when the `test_build_src <https://docs.platformio.org/en/latest//projectconf/section_env_test.html#test-build-src>`__ option is not enabled
+  - Do not immediately terminate a testing program when results are received
+  - Fixed an issue when a custom `pio test --project-config <https://docs.platformio.org/en/latest/core/userguide/cmd_test.html#cmdoption-pio-test-c>`__ was not handled properly (`issue #4299 <https://github.com/platformio/platformio-core/issues/4299>`_)
+  - Fixed an issue when testing results were wrong in the verbose mode (`issue #4336 <https://github.com/platformio/platformio-core/issues/4336>`_)
+
+* **Build System**
+
+  - Significantly improved support for `Pre & Post Actions <https://docs.platformio.org/en/latest/scripting/actions.html>`__
+
+    * Allowed to declare actions in the `PRE-type scripts <https://docs.platformio.org/en/latest/scripting/launch_types.html>`__ even if the target is not ready yet
+    * Allowed library maintainers to use Pre & Post Actions in the library `extraScript <https://docs.platformio.org/en/latest/manifests/library-json/fields/build/extrascript.html>`__
+
+  - Documented `Stringification <https://docs.platformio.org/en/latest/projectconf/section_env_build.html#stringification>`__ – converting a macro argument into a string constant (`issue #4310 <https://github.com/platformio/platformio-core/issues/4310>`_)
+  - Added new `pio run --monitor-port <https://docs.platformio.org/en/latest/core/userguide/cmd_run.html#cmdoption-pio-run-monitor-port>`__ option to specify custom device monitor port to the ``monitor`` target (`issue #4337 <https://github.com/platformio/platformio-core/issues/4337>`_)
+  - Added ``env.StringifyMacro(value)`` helper function for the `Advanced Scripting <https://docs.platformio.org/en/latest/scripting/index.html>`__
+  - Allowed to ``Import("projenv")`` in a library extra script (`issue #4305 <https://github.com/platformio/platformio-core/issues/4305>`_)
+  - Fixed an issue when the `build_unflags <https://docs.platformio.org/en/latest/projectconf/section_env_build.html#build-unflags>`__ operation ignores a flag value (`issue #4309 <https://github.com/platformio/platformio-core/issues/4309>`_)
+  - Fixed an issue when the `build_unflags <https://docs.platformio.org/en/latest/projectconf/section_env_build.html#build-unflags>`__ option was not applied to the ``ASPPFLAGS`` scope
+  - Fixed an issue on Windows OS when flags were wrapped to the temporary file while generating the `Compilation database "compile_commands.json" <https://docs.platformio.org/en/latest/integration/compile_commands.html>`__
+  - Fixed an issue with the |LDF| when recursively scanning dependencies in the ``chain`` mode
+  - Fixed a "PermissionError" on Windows when running "clean" or "cleanall" targets (`issue #4331 <https://github.com/platformio/platformio-core/issues/4331>`_)
+
+* **Package Management**
+
+  - Fixed an issue when library dependencies were installed for the incompatible project environment (`issue #4338 <https://github.com/platformio/platformio-core/issues/4338>`_)
+
+* **Miscellaneous**
+
+  - Warn about incompatible Bash version for the `Shell Completion <https://docs.platformio.org/en/latest/core/userguide/system/completion/index.html>`__ (`issue #4326 <https://github.com/platformio/platformio-core/issues/4326>`_)
+
+6.0.2 (2022-06-01)
 ~~~~~~~~~~~~~~~~~~
 
-* Allowed to pass multiple "SomePlatform" to install/uninstall commands
-* Added "IDE Integration" section to README with Eclipse project examples
-* Created auto installer script for *PlatformIO* (`issue #3 <https://github.com/platformio/platformio/issues/3>`_)
-* Added "Super-Quick" way to Installation section (README)
-* Implemented "build_flags" option for environments (`issue #4 <https://github.com/platformio/platformio/issues/4>`_)
+* Control |UNITTESTING| verbosity with a new multilevel `pio test -v <https://docs.platformio.org/en/latest/core/userguide/cmd_test.html#cmdoption-pio-test-v>`__ command option (`issue #4276 <https://github.com/platformio/platformio-core/issues/4276>`_)
+* Follow symbolic links during searching for the unit test suites (`issue #4288 <https://github.com/platformio/platformio-core/issues/4288>`_)
+* Show a warning when testing an empty project without a test suite (`issue #4278 <https://github.com/platformio/platformio-core/issues/4278>`_)
+* Improved support for `Asking for input (prompts) <https://docs.platformio.org/en/latest/scripting/examples/asking_for_input.html>`_
+* Fixed an issue when the `build_src_flags <https://docs.platformio.org/en/latest/projectconf/section_env_build.html#build-src-flags>`__ option was applied outside the project scope (`issue #4277 <https://github.com/platformio/platformio-core/issues/4277>`_)
+* Fixed an issue with debugging assembly files without preprocessor (".s")
 
-
-0.2.0 (2014-06-15)
+6.0.1 (2022-05-17)
 ~~~~~~~~~~~~~~~~~~
 
-* Resolved `issue #1 "Build referred libraries" <https://github.com/platformio/platformio/issues/1>`_
-* Renamed project's "libs" directory to "lib"
-* Added `arduino-internal-library <https://github.com/platformio/platformio/tree/develop/examples/>`_ example
-* Changed to beta status
+* Improved support for the renamed configuration options (`issue #4270 <https://github.com/platformio/platformio-core/issues/4270>`_)
+* Fixed an issue when calling the built-in `pio device monitor <https://docs.platformio.org/en/latest/core/userguide/device/cmd_monitor.html#filters>`__ filters
+* Fixed an issue when using |INTERPOLATION| and merging str+int options (`issue #4271 <https://github.com/platformio/platformio-core/issues/4271>`_)
 
-
-0.1.0 (2014-06-13)
+6.0.0 (2022-05-16)
 ~~~~~~~~~~~~~~~~~~
 
-* Birth! First alpha release
+Please check the `Migration guide from 5.x to 6.0 <https://docs.platformio.org/en/latest/core/migration.html>`__.
+
+* **Package Management**
+
+  - New unified Package Management CLI (``pio pkg``):
+
+    * `pio pkg exec <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_exec.html>`_ - run command from package tool (`issue #4163 <https://github.com/platformio/platformio-core/issues/4163>`_)
+    * `pio pkg install <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_install.html>`_ - install the project dependencies or custom packages
+    * `pio pkg list <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_list.html>`__ - list installed packages
+    * `pio pkg outdated <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_outdated.html>`__ - check for project outdated packages
+    * `pio pkg search <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_search.html>`__ - search for packages
+    * `pio pkg show <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_show.html>`__ - show package information
+    * `pio pkg uninstall <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_uninstall.html>`_ - uninstall the project dependencies or custom packages
+    * `pio pkg update <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_update.html>`__ - update the project dependencies or custom packages
+
+  - Package Manifest
+
+    * Added support for `"scripts" <https://docs.platformio.org/en/latest/librarymanager/config.html#scripts>`__ (`issue #485 <https://github.com/platformio/platformio-core/issues/485>`_)
+    * Added support for `multi-licensed <https://docs.platformio.org/en/latest/librarymanager/config.html#license>`__ packages using SPDX Expressions (`issue #4037 <https://github.com/platformio/platformio-core/issues/4037>`_)
+    * Added support for `"dependencies" <https://docs.platformio.org/en/latest/librarymanager/config.html#dependencies>`__ declared in a "tool" package manifest
+
+  - Added support for `symbolic links <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_install.html#local-folder>`__ allowing pointing the local source folder to the Package Manager (`issue #3348 <https://github.com/platformio/platformio-core/issues/3348>`_)
+  - Automatically install dependencies of the local (private) project libraries (`issue #2910 <https://github.com/platformio/platformio-core/issues/2910>`_)
+  - Improved detection of a package type from the tarball archive (`issue #3828 <https://github.com/platformio/platformio-core/issues/3828>`_)
+  - Ignore files according to the patterns declared in ".gitignore" when using the `pio package pack <https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_pack.html>`__ command (`issue #4188 <https://github.com/platformio/platformio-core/issues/4188>`_)
+  - Dropped automatic updates of global libraries and development platforms (`issue #4179 <https://github.com/platformio/platformio-core/issues/4179>`_)
+  - Dropped support for the "pythonPackages" field in "platform.json" manifest in favor of `Extra Python Dependencies <https://docs.platformio.org/en/latest/scripting/examples/extra_python_packages.html>`__
+  - Fixed an issue when manually removed dependencies from the |PIOCONF| were not uninstalled from the storage (`issue #3076 <https://github.com/platformio/platformio-core/issues/3076>`_)
+
+* **Unit Testing**
+
+  - Refactored from scratch |UNITTESTING| solution and its documentation
+  - New: `Test Hierarchy <https://docs.platformio.org/en/latest/advanced/unit-testing/structure.html>`_ (`issue #4135 <https://github.com/platformio/platformio-core/issues/4135>`_)
+  - New: `Doctest <https://docs.platformio.org/en/latest/advanced/unit-testing/frameworks/doctest.html>`__ testing framework (`issue #4240 <https://github.com/platformio/platformio-core/issues/4240>`_)
+  - New: `GoogleTest <https://docs.platformio.org/en/latest/advanced/unit-testing/frameworks/googletest.html>`__ testing and mocking framework (`issue #3572 <https://github.com/platformio/platformio-core/issues/3572>`_)
+  - New: `Semihosting <https://docs.platformio.org/en/latest/advanced/unit-testing/semihosting.html>`__ (`issue #3516 <https://github.com/platformio/platformio-core/issues/3516>`_)
+  - New: Hardware `Simulators <https://docs.platformio.org/en/latest/advanced/unit-testing/simulators/index.html>`__ for Unit Testing (QEMU, Renode, SimAVR, and custom solutions)
+  - New: ``test`` `build configuration <https://docs.platformio.org/en/latest/projectconf/build_configurations.html>`__
+  - Added support for a `custom testing framework <https://docs.platformio.org/en/latest/advanced/unit-testing/frameworks/custom/index.html>`_
+  - Added support for a custom `testing command <https://docs.platformio.org/en/latest/projectconf/section_env_test.html#test-testing-command>`__
+  - Added support for a `custom Unity library <https://docs.platformio.org/en/latest/advanced/unit-testing/frameworks/custom/examples/custom_unity_library.html>`__ (`issue #3980 <https://github.com/platformio/platformio-core/issues/3980>`_)
+  - Added support for the ``socket://`` and ``rfc2217://`` protocols using `test_port <https://docs.platformio.org/en/latest/projectconf/section_env_test.html#test-port>`__ option (`issue #4229 <https://github.com/platformio/platformio-core/issues/4229>`_)
+  - List available project tests with a new `pio test --list-tests <https://docs.platformio.org/en/latest/core/userguide/cmd_test.html#cmdoption-pio-test-list-tests>`__ option
+  - Pass extra arguments to the testing program with a new `pio test --program-arg <https://docs.platformio.org/en/latest/core/userguide/cmd_test.html#cmdoption-pio-test-a>`__ option (`issue #3132 <https://github.com/platformio/platformio-core/issues/3132>`_)
+  - Generate reports in JUnit and JSON formats using the `pio test <https://docs.platformio.org/en/latest/core/userguide/cmd_test.html>`__ command (`issue #2891 <https://github.com/platformio/platformio-core/issues/2891>`_)
+  - Provide more information when the native program crashed on a host (errored with a non-zero return code) (`issue #3429 <https://github.com/platformio/platformio-core/issues/3429>`_)
+  - Improved automatic detection of a testing serial port (`issue #4076 <https://github.com/platformio/platformio-core/issues/4076>`_)
+  - Fixed an issue when command line parameters (``--ignore``, ``--filter``) do not override values defined in the |PIOCONF| (`issue #3845 <https://github.com/platformio/platformio-core/issues/3845>`_)
+  - Renamed the "test_build_project_src" project configuration option to the `test_build_src <https://docs.platformio.org/en/latest//projectconf/section_env_test.html#test-build-src>`__
+  - Removed the "test_transport" option in favor of the `Custom "unity_config.h" <https://docs.platformio.org/en/latest/advanced/unit-testing/frameworks/unity.html>`_
+
+* **Static Code Analysis**
+
+  - Updated analysis tools:
+
+    * `Cppcheck <https://docs.platformio.org/en/latest/plus/check-tools/cppcheck.html>`__ v2.7 with various checker improvements and fixed false positives
+    * `PVS-Studio <https://docs.platformio.org/en/latest/plus/check-tools/pvs-studio.html>`__ v7.18 with improved and updated semantic analysis system
+
+  - Added support for the custom `Clang-Tidy <https://docs.platformio.org/en/latest/plus/check-tools/clang-tidy.html>`__ configuration file (`issue #4186 <https://github.com/platformio/platformio-core/issues/4186>`_)
+  - Added ability to override a tool version using the `platform_packages <https://docs.platformio.org/en/latest/projectconf/section_env_platform.html#platform-packages>`__ option (`issue #3798 <https://github.com/platformio/platformio-core/issues/3798>`_)
+  - Fixed an issue with improper handling of defects that don't specify a source file (`issue #4237 <https://github.com/platformio/platformio-core/issues/4237>`_)
+
+* **Build System**
+
+  - Show project dependency licenses when building in the verbose mode
+  - Fixed an issue when |LDF| ignores the project `lib_deps <https://docs.platformio.org/en/latest/projectconf/section_env_library.html#lib-deps>`__ while resolving library dependencies (`issue #3598 <https://github.com/platformio/platformio-core/issues/3598>`_)
+  - Fixed an issue with calling an extra script located outside a project (`issue #4220 <https://github.com/platformio/platformio-core/issues/4220>`_)
+  - Fixed an issue when GCC preprocessor was applied to the ".s" assembly files on case-sensitive OS such as Window OS (`issue #3917 <https://github.com/platformio/platformio-core/issues/3917>`_)
+  - Fixed an issue when |LDF| ignores `build_src_flags <https://docs.platformio.org/en/latest/projectconf/section_env_build.html#build-src-flags>`__ in the "deep+" mode (`issue #4253 <https://github.com/platformio/platformio-core/issues/4253>`_)
+
+* **Integration**
+
+  - Added a new build variable (``COMPILATIONDB_INCLUDE_TOOLCHAIN``) to include toolchain paths in the compilation database (`issue #3735 <https://github.com/platformio/platformio-core/issues/3735>`_)
+  - Changed a default path for compilation database `compile_commands.json <https://docs.platformio.org/en/latest/integration/compile_commands.html>`__ to the project root
+  - Enhanced integration for Qt Creator (`issue #3046 <https://github.com/platformio/platformio-core/issues/3046>`_)
+
+* **Project Configuration**
+
+  - Extended |INTERPOLATION| with ``${this}`` pattern (`issue #3953 <https://github.com/platformio/platformio-core/issues/3953>`_)
+  - Embed environment name of the current section in the |PIOCONF| using ``${this.__env__}`` pattern
+  - Renamed the "src_build_flags" project configuration option to the `build_src_flags <https://docs.platformio.org/en/latest/projectconf/section_env_build.html#build-src-flags>`__
+  - Renamed the "src_filter" project configuration option to the `build_src_filter <https://docs.platformio.org/en/latest/projectconf/section_env_build.html#build-src-filter>`__
+
+* **Miscellaneous**
+
+  - Pass extra arguments to the `native <https://docs.platformio.org/en/latest/platforms/native.html>`__ program with a new `pio run --program-arg <https://docs.platformio.org/en/latest/core/userguide/cmd_run.html#cmdoption-pio-run-a>`__ option (`issue #4246 <https://github.com/platformio/platformio-core/issues/4246>`_)
+  - Improved PIO Remote setup on credit-card sized computers (Raspberry Pi, BeagleBon, etc) (`issue #3865 <https://github.com/platformio/platformio-core/issues/3865>`_)
+  - Finally removed all tracks to the Python 2.7, the Python 3.6 is the minimum supported version.
+
+.. _release_notes_5:
+
+PlatformIO Core 5
+-----------------
+
+See `PlatformIO Core 5.0 history <https://github.com/platformio/platformio-core/blob/v5.2.5/HISTORY.rst>`__.
+
+.. _release_notes_4:
+
+PlatformIO Core 4
+-----------------
+
+See `PlatformIO Core 4.0 history <https://github.com/platformio/platformio-core/blob/v4.3.4/HISTORY.rst>`__.
+
+PlatformIO Core 3
+-----------------
+
+See `PlatformIO Core 3.0 history <https://github.com/platformio/platformio-core/blob/v3.6.7/HISTORY.rst>`__.
+
+PlatformIO Core 2
+-----------------
+
+See `PlatformIO Core 2.0 history <https://github.com/platformio/platformio-core/blob/v2.11.2/HISTORY.rst>`__.
+
+PlatformIO Core 1
+-----------------
+
+See `PlatformIO Core 1.0 history <https://github.com/platformio/platformio-core/blob/v1.5.0/HISTORY.rst>`__.
+
+PlatformIO Core Preview
+-----------------------
+
+See `PlatformIO Core Preview history <https://github.com/platformio/platformio-core/blob/v0.10.2/HISTORY.rst>`__.

LICENSE

@@ -1,21 +1,174 @@
-The MIT License (MIT)
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
 
-Copyright (c) 2014-2015 Ivan Kravets
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+1. Definitions.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+  Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+  stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+  that You distribute, all copyright, patent, trademark, and
+  attribution notices from the Source form of the Work,
+  excluding those notices that do not pertain to any part of
+  the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+  distribution, then any Derivative Works that You distribute must
+  include a readable copy of the attribution notices contained
+  within such NOTICE file, excluding those notices that do not
+  pertain to any part of the Derivative Works, in at least one
+  of the following places: within a NOTICE text file distributed
+  as part of the Derivative Works; within the Source form or
+  documentation, if provided along with the Derivative Works; or,
+  within a display generated by the Derivative Works, if and
+  wherever such third-party notices normally appear. The contents
+  of the NOTICE file are for informational purposes only and
+  do not modify the License. You may add Your own attribution
+  notices within Derivative Works that You distribute, alongside
+  or as an addendum to the NOTICE text from the Work, provided
+  that such additional attribution notices cannot be construed
+  as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.

Makefile

@@ -0,0 +1,38 @@
+lint:
+	pylint --rcfile=./.pylintrc ./tests
+	pylint --rcfile=./.pylintrc ./platformio
+
+isort:
+	isort ./platformio
+	isort ./tests
+
+format:
+	black ./platformio
+	black ./tests
+
+test:
+	pytest --verbose --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,174 +1,103 @@
-PlatformIO
-==========
+PlatformIO Core
+===============
 
-.. 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://circleci.com/gh/platformio/platformio/tree/develop.svg?style=svg
-    :target: https://circleci.com/gh/platformio/platformio/tree/develop
-    :alt: Circle.CI Build Status
-.. image:: https://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/en/latest/core/index.html
+    :alt:  CI Build for PlatformIO Core
+.. 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://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/Projects/badge.svg
+    :target: https://docs.platformio.org/en/latest/tutorials/index.html#projects
+    :alt:  CI Build for the Community Projects
 .. 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
-    :target: https://pypi.python.org/pypi/platformio/
-    :alt:  License
-.. image:: https://img.shields.io/pypi/dm/platformio.svg
-    :target: https://pypi.python.org/pypi/platformio/
-    :alt: PyPi Downloads
-.. image:: https://img.shields.io/sourceforge/dm/platformio-storage.svg
-    :target: https://sourceforge.net/projects/platformio-storage/
-    :alt: Packages Downloads
-.. image:: https://badges.gitter.im/Join%20Chat.svg
-   :alt: Join the chat at https://gitter.im/platformio/platformio
-   :target: https://gitter.im/platformio/platformio
+.. image:: https://img.shields.io/badge/PlatformIO-Labs-orange.svg
+   :alt: PlatformIO Labs
+   :target: https://piolabs.com/?utm_source=github&utm_medium=core
 
-`Home & Demo <http://platformio.org>`_ |
-`Project Examples <https://github.com/platformio/platformio/tree/develop/examples>`_ |
-`Code <https://github.com/platformio/platformio>`_ |
-`Documentation <http://docs.platformio.org>`_ ||
-`Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
-`Reddit <http://www.reddit.com/r/platformio/>`_ |
+**Quick Links:** `Homepage <https://platformio.org?utm_source=github&utm_medium=core>`_ |
+`PlatformIO IDE <https://platformio.org/platformio-ide?utm_source=github&utm_medium=core>`_ |
+`Registry <https://registry.platformio.org?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>`_
+
+**Social:** `LinkedIn <https://www.linkedin.com/company/platformio/>`_ |
+`Twitter <https://twitter.com/PlatformIO_Org>`_ |
 `Facebook <https://www.facebook.com/platformio>`_ |
-`Twitter <https://twitter.com/PlatformIO_Org>`_
+`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 a cross-platform code builder
-and the missing library manager (Ready for embedded development, IDE and
-Continuous integration, Arduino and MBED compatible).
+`PlatformIO <https://platformio.org>`_: Your Gateway to Embedded Software Development Excellence.
 
-*Atmel AVR & SAM, Espressif, Freescale Kinetis, Nordic nRF51, NXP LPC,
-Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed,
-libOpenCM3, etc.*
+Unlock the true potential of embedded software development with
+PlatformIO's collaborative ecosystem, embracing declarative principles,
+test-driven methodologies, and modern toolchains for unrivaled success.
 
-.. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-demo-wiring.gif
-    :target: http://platformio.org
+* 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
 
-* `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 History <http://docs.platformio.org/en/latest/history.html>`_
+Get Started
+-----------
 
-You have **no need** to install any *IDE* or compile any tool chains. *PlatformIO*
-has pre-built different development platforms and pre-configured settings for
-the most popular embedded boards. For further details, please
-refer to `What is PlatformIO? <http://docs.platformio.org/en/latest/faq.html#what-is-platformio>`_
+* `What is PlatformIO? <https://docs.platformio.org/en/latest/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/en/latest/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 operation 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/en/latest/librarymanager/index.html?utm_source=github&utm_medium=core>`_
+* `Desktop IDEs Integration <https://docs.platformio.org/en/latest/ide.html?utm_source=github&utm_medium=core>`_
+* `Continuous Integration <https://docs.platformio.org/en/latest/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, Eclipse, Energia, Qt Creator, Sublime Text, Vim, Visual Studio*
-* `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/en/latest/plus/debugging.html?utm_source=github&utm_medium=core>`_
+* `Unit Testing <https://docs.platformio.org/en/latest/advanced/unit-testing/index.html?utm_source=github&utm_medium=core>`_
+* `Static Code Analysis <https://docs.platformio.org/en/latest/plus/pio-check.html?utm_source=github&utm_medium=core>`_
+* `Remote Development <https://docs.platformio.org/en/latest/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://registry.platformio.org/search?t=library&utm_source=github&utm_medium=core>`_
+* `Development Platforms <https://registry.platformio.org/search?t=platform&utm_source=github&utm_medium=core>`_
+* `Development Tools <https://registry.platformio.org/search?t=tool&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
+Contributing
+------------
 
-Smart Code Builder. *Fast and Reliable.*
-----------------------------------------
-*PlatformIO Code Builder* is built-on a next-generation software construction
-tool named `SCons <http://www.scons.org/>`_. Think of *SCons* as an improved,
-cross-platform substitute for the classic *Make* utility.
+See `contributing guidelines <https://github.com/platformio/platformio/blob/develop/CONTRIBUTING.md>`_.
 
-* 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>`_
+Telemetry / Privacy Policy
+--------------------------
 
-.. image:: https://raw.githubusercontent.com/platformio/platformio-web/develop/app/images/platformio-scons-builder.png
-    :target: http://platformio.org
-    :alt:  PlatformIO Code Builder Architecture
+Share minimal diagnostics and usage information to help us make PlatformIO better.
+It is enabled by default. For more information see:
 
-Single source code. *Multiple platforms.*
------------------------------------------
-*PlatformIO* allows developer to compile the same code with different
-development platforms using the *Only One Command*
-`platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`_.
-This happens due to
-`Project Configuration File (platformio.ini) <http://docs.platformio.org/en/latest/projectconf.html>`_
-where you can setup different environments with specific options (platform
-type, firmware uploading settings, pre-built framework, build flags and many
-more).
+* `Telemetry Setting <https://docs.platformio.org/en/latest/userguide/cmd_settings.html?utm_source=github&utm_medium=core#enable-telemetry>`_
 
-It has support for the most popular embedded platforms:
-
-* `Atmel AVR <http://platformio.org/#!/platforms/atmelavr>`_
-* `Atmel SAM <http://platformio.org/#!/platforms/atmelsam>`_
-* `Espressif <http://platformio.org/#!/platforms/espressif>`_
-* `Freescale Kinetis <http://platformio.org/#!/platforms/freescalekinetis>`_
-* `Nordic nRF51 <http://platformio.org/#!/platforms/nordicnrf51>`_
-* `NXP LPC <http://platformio.org/#!/platforms/nxplpc>`_
-* `ST STM32 <http://platformio.org/#!/platforms/ststm32>`_
-* `Silicon Labs EFM32 <http://platformio.org/#!/platforms/siliconlabsefm32>`_
-* `Teensy <http://platformio.org/#!/platforms/teensy>`_
-* `TI MSP430 <http://platformio.org/#!/platforms/timsp430>`_
-* `TI TIVA C <http://platformio.org/#!/platforms/titiva>`_
-
-Frameworks:
-
-* `Arduino <http://platformio.org/#!/frameworks/arduino>`_
-* `CMSIS <http://platformio.org/#!/frameworks/cmsis>`_
-* `libOpenCM3 <http://platformio.org/#!/frameworks/libopencm3>`_
-* `Energia <http://platformio.org/#!/frameworks/energia>`_
-* `SPL <http://platformio.org/#!/frameworks/spl>`_
-* `mbed <http://platformio.org/#!/frameworks/mbed>`_
-
-
-Licence
+License
 -------
 
-Copyright (C) 2014-2015 Ivan Kravets
+Copyright (c) 2014-present PlatformIO <contact@platformio.org>
 
-Licenced under the MIT 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.
+
+.. image:: https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner-direct.svg
+    :target: https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md
+    :alt:  SWUbanner

SECURITY.md

@@ -0,0 +1,34 @@
+# Security Policy
+
+## Supported Versions
+
+We are committed to ensuring the security and protection of PlatformIO Core. 
+To this end, we support only the following versions:
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 6.1.x   | :white_check_mark: |
+| < 6.1   | :x:                |
+
+Unsupported versions of the PlatformIO Core may have known vulnerabilities or security issues that could compromise the security of our organization's systems and data. 
+Therefore, it is important that all developers use only supported versions of the PlatformIO Core.
+
+## Reporting a Vulnerability
+
+We take the security of our systems and data very seriously. We encourage responsible disclosure of any vulnerabilities or security issues that you may find in our systems or applications. If you believe you have discovered a vulnerability, please report it to us immediately.
+
+To report a vulnerability, please send an email to our security team at contact@piolabs.com. Please include as much information as possible, including:
+
+- A description of the vulnerability and how it can be exploited
+- Steps to reproduce the vulnerability
+- Any additional information that can help us understand and reproduce the vulnerability
+
+Once we receive your report, our security team will acknowledge receipt within 24 hours and will work to validate the reported vulnerability. We will provide periodic updates on the progress of the vulnerability assessment, and will notify you once a fix has been deployed.
+
+If the vulnerability is accepted, we will work to remediate the issue as quickly as possible. We may also provide credit or recognition to the individual who reported the vulnerability, at our discretion.
+
+If the vulnerability is declined, we will provide a justification for our decision and may offer guidance on how to improve the report or how to test the system more effectively.
+
+Please note that we will not take any legal action against individuals who report vulnerabilities in good faith and in accordance with this policy.
+
+Thank you for helping us keep our systems and data secure.

appveyor.yml

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

circle.yml

@@ -1,20 +0,0 @@
-machine:
-    python:
-        version: 2.7
-    environment:
-        TOX_ENV: docs
-        TOX_ENV: lint
-        TOX_ENV: py26
-        TOX_ENV: py27
-
-checkout:
-    post:
-        - git submodule update --init
-
-dependencies:
-    pre:
-        - pip install tox
-
-test:
-    override:
-        - tox -e $TOX_ENV

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/articles.rst

@@ -1,34 +0,0 @@
-.. _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:
-
-2015
-^^^^
-
-* 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 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 (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 (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/>`_
-* Jun 02, 2015 - **Alejandro Guirao Rodriguez** - `Discovering PlatformIO: The RaspberryPi / Arduino combo kit is a winner option when prototyping an IoT-style project <http://lekum.org/posts/discovering-platformio.html>`_
-* May 11, 2015 - **IT Hare** - `From Web Developer to Embedded One: Interview with Ivan Kravets, The Guy Behind PlatformIO. Part II <http://ithare.com/from-web-developer-to-embedded-one-interview-with-ivan-kravets-the-guy-behind-platformio-part-ii/>`_
-* May 4, 2015 - **IT Hare** - `From Web Developer to Embedded One: Interview with Ivan Kravets, The Guy Behind PlatformIO. Part I <http://ithare.com/from-web-development-to-embedded-one-interview-with-ivan-kravets-the-guy-behind-platformio-part-i/>`_
-* April 17, 2015 - **Michael Ball** - `PlatformIO - A Cross-Platform Code Builder and Missing Library Manager <http://arduino-pi.blogspot.com.es/2015/04/platformio-cross-platform-code-builder.html>`_
-* March 23, 2015 - **Atmel** - `Cross-board and cross-vendor embedded development with PlatformIO <http://blog.atmel.com/2015/03/23/cross-board-and-cross-vendor-embedded-development-with-platformio/>`_
-* March 22, 2015 - **Mark VandeWettering** - `Discovered a new tool for embedded development: PlatformIO <http://brainwagon.org/2015/03/22/discovered-a-new-tool-for-embedded-development-platformio/>`_
-* February 25, 2015 - **Hendrik Putzek** - `Use your favourite IDE together with Arduino <http://blog.putzek.com/2015/02/your-favourite-ide-with-arduino.html>`_
-
-2014
-^^^^
-
-* October 7, 2014 - **Ivan Kravets, Ph.D.** - `Integration of PlatformIO library manager to Arduino and Energia IDEs <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_
-* June 20, 2014 - **Ivan Kravets, Ph.D.** - `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_
-* June 17, 2014 - **Ivan Kravets, Ph.D.** - `How was PlatformIO born or why I love Python World <http://www.ikravets.com/computer-life/programming/2014/06/17/how-was-platformio-born-or-why-i-love-python-world>`_

docs/ci/appveyor.rst

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

docs/ci/circleci.rst

@@ -1,72 +0,0 @@
-.. _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`.
-
-Integration
------------
-
-Put ``circle.yml`` to the root directory of the GitHub repository.
-
-.. code-block:: yaml
-
-    machine:
-        environment:
-            PLATFORMIO_CI_SRC: path/to/source/file.c
-            PLATFORMIO_CI_SRC: path/to/source/file.ino
-            PLATFORMIO_CI_SRC: path/to/source/directory
-
-    dependencies:
-        pre:
-            - sudo apt-get install python2.7-dev
-            - sudo python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
-
-    test:
-        override:
-            - 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 ``circle.yml`` configuration file:
-
-.. code-block:: yaml
-
-    machine:
-        environment:
-            PLATFORMIO_CI_SRC: examples/Bluetooth/PS3SPP/PS3SPP.ino
-            PLATFORMIO_CI_SRC: examples/pl2303/pl2303_gps/pl2303_gps.ino
-
-    dependencies:
-        pre:
-            - sudo apt-get install python2.7-dev
-            - sudo python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
-            - wget https://github.com/xxxajk/spi4teensy3/archive/master.zip -O /tmp/spi4teensy3.zip
-            - unzip /tmp/spi4teensy3.zip -d /tmp
-
-    test:
-        override:
-            - platformio ci --lib="." --lib="/tmp/spi4teensy3-master" --board=uno --board=teensy31 --board=due

docs/ci/drone.rst

@@ -1,70 +0,0 @@
-.. _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`.
-
-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
-
-    python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
-    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
-
-    python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
-    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,24 +0,0 @@
-.. _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,76 +0,0 @@
-.. _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`.
-
-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:
-        - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
-
-    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:
-        - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
-        - 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,83 +0,0 @@
-.. _ci_travis:
-
-Travis CI
-=========
-
-`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`.
-
-Integration
------------
-
-Please put ``.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:
-        - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
-
-    script:
-        - platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-
-Then see step 1, 2, and step 4 here: http://docs.travis-ci.com/user/getting-started/
-
-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 ``.travis.yml`` configuration file:
-
-.. code-block:: yaml
-
-    language: python
-    python:
-        - "2.7"
-
-    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:
-        - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
-
-        # 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

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

docs/demo.rst

@@ -1,50 +0,0 @@
-.. _demo:
-
-Demo
-====
-
-.. contents::
-
-Wiring Blink
-------------
-
-.. image:: _static/platformio-demo-wiring.gif
-
-Used in demo
-~~~~~~~~~~~~
-
-1. Source code of `Wiring Blink Example <https://github.com/platformio/platformio/tree/develop/examples/wiring-blink>`_
-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.

docs/envvars.rst

@@ -1,100 +0,0 @@
-.. _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.
-Currently, PlatformIO uses it to disable prompts.
-
-In other words, ``CI=true`` automatically setup
-:envvar:`PLATFORMIO_SETTING_ENABLE_PROMPTS=false <PLATFORMIO_SETTING_ENABLE_PROMPTS>`.
-
-.. 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`.
-
-
-Builder
--------
-
-.. envvar:: PLATFORMIO_BUILD_FLAGS
-
-Allows to set :ref:`projectconf` option :ref:`projectconf_build_flags`.
-
-.. 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`.
-
-
-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,137 +0,0 @@
-.. _faq:
-
-Frequently Asked Questions
-==========================
-
-.. contents::
-
-General
--------
-
-.. _faq_what_is_platformio:
-
-What is PlatformIO?
-~~~~~~~~~~~~~~~~~~~
-
-`PlatformIO <http://platformio.org>`_ is a cross-platform code builder
-and the missing library manager.
-
-PlatformIO is independent from the platform, in which it is running. In fact,
-the only requirement is Python, which exists pretty much everywhere. What this
-means is that PlatformIO projects can be easily moved from one computer to
-another, as well as that PlatformIO allows for the easy sharing of projects
-between team members, regardless of operating system they prefer to work with.
-Beyond that, PlatformIO can be run not only on commonly used desktops/laptops
-but also on the servers without X Window System. While PlatformIO itself is a
-console application, it can be used in combination with one's favorite
-:ref:`ide` or text editor such as :ref:`ide_arduino`, :ref:`ide_eclipse`,
-:ref:`ide_visualstudio`, :ref:`ide_vim`,  :ref:`ide_sublimetext`, etc.
-
-Alright, so PlatformIO can run on different operating systems. But more
-importantly, from development perspective at least, is a list of supported
-boards and MCUs. To keep things short: PlatformIO supports over 100
-:ref:`Embedded Boards <platforms>` and all major
-:ref:`Development Platforms <platforms>`.
-
-PlatformIO allows users to:
-
-* Decide which operation system they want to run development process on.
-  You can even use one OS at home and another at work.
-* Choose which editor to use for writing the code. It can be pretty simple
-  editor or powerful favorite :ref:`ide`.
-* Focus on the code development, significantly simplifying support for the
-  :ref:`platforms` and MCUs.
-
-
-How does it work?
-~~~~~~~~~~~~~~~~~
-
-Without going too deep into PlatformIO implementation details, work cycle of
-the project developed using PlatformIO is as follows:
-
-* Users choose board(s) interested in :ref:`projectconf`
-* Based on this list of boards, PlatformIO downloads required toolchains and
-  installs them automatically.
-* Users develop code and PlatformIO makes sure that it is compiled, prepared
-  and uploaded to all the boards of interest.
-
-.. _faq_troubleshooting:
-
-Troubleshooting
----------------
-
-.. _faq_troubleshooting_pioblocksprompt:
-
-PlatformIO blocks command execution using user prompt
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you are going to run *PlatformIO* from **subprocess**, you **MUST
-DISABLE** all prompts. It will allow you to avoid blocking.
-There are a few options:
-
-- using :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>`.
-
-.. _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
-
-    # for 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`` and ``scons``
-programs 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>`_.
-
-Serial does not work with panStampAVR board
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Answered in `issue #144 <https://github.com/platformio/platformio/issues/144#issuecomment-87388038>`_.
-
-
-PlatformIO: command not found || An error ``pkg_resources.DistributionNotFound``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Please upgrade *SetupTools* package:
-
-.. code-block:: bash
-
-    $ [sudo] pip uninstall setuptools
-    $ [sudo] pip install setuptools
-
-    # Then re-install PlatformIO
-    $ [sudo] pip uninstall platformio
-    $ [sudo] pip install platformio
-
-Windows: ``AttributeError: 'module' object has no attribute 'packages'``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Answered in `issue #252 <https://github.com/platformio/platformio/issues/252#issuecomment-127072039>`_.
-
-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>`_.

docs/frameworks/arduino.rst

@@ -1,958 +0,0 @@
-.. _framework_arduino:
-
-Framework ``arduino``
-=====================
-Arduino Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
-
-For more detailed information please visit `vendor site <http://arduino.cc/en/Reference/HomePage>`_.
-
-.. contents::
-
-Platforms
----------
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Description
-
-    * - :ref:`platform_atmelavr`
-      - Atmel AVR 8- and 32-bit MCUs deliver a unique combination of performance, power efficiency and design flexibility. Optimized to speed time to market-and easily adapt to new ones-they are based on the industrys most code-efficient architecture for C and assembly programming.
-
-    * - :ref:`platform_atmelsam`
-      - Atmel | SMART offers Flash- based ARM products based on the ARM Cortex-M0+, Cortex-M3 and Cortex-M4 architectures, ranging from 8KB to 2MB of Flash including a rich peripheral and feature mix.
-
-    * - :ref:`platform_espressif`
-      - Espressif Systems is a privately held fabless semiconductor company. They provide wireless communications and Wi-Fi chips which are widely used in mobile devices and the Internet of Things applications.
-
-    * - :ref:`platform_teensy`
-      - Teensy is a complete USB-based microcontroller development system, in a very small footprint, capable of implementing many types of projects. All programming is done via the USB port. No special programmer is needed, only a standard "Mini-B" USB cable and a PC or Macintosh with a USB port.
-
-    * - :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.
-
-Boards
-------
-
-.. note::
-    * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
-    * For more detailed ``board`` information please scroll tables below by horizontal.
-
-Adafruit
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``flora8``
-      - `Adafruit Flora <http://www.adafruit.com/product/659>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``gemma``
-      - `Adafruit Gemma <http://www.adafruit.com/products/1222>`_
-      - ATTINY85
-      - 8 MHz
-      - 8 Kb
-      - 0.5 Kb
-
-    * - ``protrinket3``
-      - `Adafruit Pro Trinket 3V/12MHz (USB) <http://www.adafruit.com/products/2010>`_
-      - ATMEGA328P
-      - 12 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``protrinket3ftdi``
-      - `Adafruit Pro Trinket 3V/12MHz (FTDI) <http://www.adafruit.com/products/2010>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``protrinket5``
-      - `Adafruit Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``protrinket5ftdi``
-      - `Adafruit Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``trinket3``
-      - `Adafruit Trinket 3V/8MHz <http://www.adafruit.com/products/1500>`_
-      - ATTINY85
-      - 8 MHz
-      - 8 Kb
-      - 0.5 Kb
-
-    * - ``trinket5``
-      - `Adafruit Trinket 5V/16MHz <http://www.adafruit.com/products/1501>`_
-      - ATTINY85
-      - 16 MHz
-      - 8 Kb
-      - 0.5 Kb
-
-Arduino
-~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``LilyPadUSB``
-      - `Arduino LilyPad USB <http://arduino.cc/en/Main/ArduinoBoardLilyPadUSB>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``atmegangatmega168``
-      - `Arduino NG or older ATmega168 <http://arduino.cc/en/main/boards>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``atmegangatmega8``
-      - `Arduino NG or older ATmega8 <http://arduino.cc/en/main/boards>`_
-      - ATMEGA8
-      - 16 MHz
-      - 8 Kb
-      - 1 Kb
-
-    * - ``btatmega168``
-      - `Arduino BT ATmega168 <http://arduino.cc/en/main/boards>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``btatmega328``
-      - `Arduino BT ATmega328 <http://arduino.cc/en/main/boards>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``diecimilaatmega168``
-      - `Arduino Duemilanove or Diecimila ATmega168 <http://arduino.cc/en/Main/ArduinoBoardDiecimila>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``diecimilaatmega328``
-      - `Arduino Duemilanove or Diecimila ATmega328 <http://arduino.cc/en/Main/ArduinoBoardDiecimila>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``due``
-      - `Arduino Due (Programming Port) <http://arduino.cc/en/Main/arduinoBoardDue>`_
-      - AT91SAM3X8E
-      - 84 MHz
-      - 512 Kb
-      - 32 Kb
-
-    * - ``dueUSB``
-      - `Arduino Due (USB Native Port) <http://arduino.cc/en/Main/arduinoBoardDue>`_
-      - AT91SAM3X8E
-      - 84 MHz
-      - 512 Kb
-      - 32 Kb
-
-    * - ``esplora``
-      - `Arduino Esplora <http://arduino.cc/en/Main/ArduinoBoardEsplora>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``ethernet``
-      - `Arduino Ethernet <http://arduino.cc/en/Main/ArduinoBoardEthernet>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``fio``
-      - `Arduino Fio <http://arduino.cc/en/Main/ArduinoBoardFio>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``leonardo``
-      - `Arduino Leonardo <http://arduino.cc/en/Main/arduinoBoardLeonardo>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``lilypadatmega168``
-      - `Arduino LilyPad ATmega168 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
-      - ATMEGA168
-      - 8 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``lilypadatmega328``
-      - `Arduino LilyPad ATmega328 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``megaADK``
-      - `Arduino Mega ADK <http://arduino.cc/en/Main/ArduinoBoardMegaADK>`_
-      - ATMEGA2560
-      - 16 MHz
-      - 256 Kb
-      - 8 Kb
-
-    * - ``megaatmega1280``
-      - `Arduino Mega or Mega 2560 ATmega1280 <http://arduino.cc/en/Main/arduinoBoardMega>`_
-      - ATMEGA1280
-      - 16 MHz
-      - 128 Kb
-      - 8 Kb
-
-    * - ``megaatmega2560``
-      - `Arduino Mega or Mega 2560 ATmega2560 (Mega 2560) <http://arduino.cc/en/Main/arduinoBoardMega2560>`_
-      - ATMEGA2560
-      - 16 MHz
-      - 256 Kb
-      - 8 Kb
-
-    * - ``micro``
-      - `Arduino Micro <http://arduino.cc/en/Main/ArduinoBoardMicro>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``miniatmega168``
-      - `Arduino Mini ATmega168 <http://arduino.cc/en/Main/ArduinoBoardMini>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``miniatmega328``
-      - `Arduino Mini ATmega328 <http://arduino.cc/en/Main/ArduinoBoardMini>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``nanoatmega168``
-      - `Arduino Nano ATmega168 <http://arduino.cc/en/Main/ArduinoBoardNano>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``nanoatmega328``
-      - `Arduino Nano ATmega328 <http://arduino.cc/en/Main/ArduinoBoardNano>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``pro16MHzatmega168``
-      - `Arduino Pro or Pro Mini ATmega168 (5V, 16 MHz) <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``pro16MHzatmega328``
-      - `Arduino Pro or Pro Mini ATmega328 (5V, 16 MHz) <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``pro8MHzatmega168``
-      - `Arduino Pro or Pro Mini ATmega168 (3.3V, 8 MHz) <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
-      - ATMEGA168
-      - 8 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``pro8MHzatmega328``
-      - `Arduino Pro or Pro Mini ATmega328 (3.3V, 8 MHz) <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``robotControl``
-      - `Arduino Robot Control <http://arduino.cc/en/Main/Robot>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``robotMotor``
-      - `Arduino Robot Motor <http://arduino.cc/en/Main/Robot>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``uno``
-      - `Arduino Uno <http://arduino.cc/en/Main/ArduinoBoardUno>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``yun``
-      - `Arduino Yun <http://arduino.cc/en/Main/ArduinoBoardYun>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-BQ
-~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``zumbt328``
-      - `BQ ZUM BT-328 board <http://www.bq.com/gb/products/zum.html>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-BitWizard
-~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``raspduino``
-      - `BitWizard Raspduino <http://www.bitwizard.nl/wiki/index.php/Raspduino>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-Digistump
-~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``digispark-pro``
-      - `Digistump Digispark Pro (Default 16 MHz) <http://digistump.com/products/109>`_
-      - ATTINY167
-      - 16 MHz
-      - 16 Kb
-      - 0.5 Kb
-
-    * - ``digispark-pro32``
-      - `Digistump Digispark Pro (16 MHz) (32 byte buffer) <http://digistump.com/products/109>`_
-      - ATTINY167
-      - 16 MHz
-      - 16 Kb
-      - 0.5 Kb
-
-    * - ``digispark-pro64``
-      - `Digistump Digispark Pro (16 MHz) (64 byte buffer) <http://digistump.com/products/109>`_
-      - ATTINY167
-      - 16 MHz
-      - 16 Kb
-      - 0.5 Kb
-
-    * - ``digispark-tiny``
-      - `Digistump Digispark (Default - 16 MHz) <http://digistump.com/products/1>`_
-      - ATTINY85
-      - 16 MHz
-      - 8 Kb
-      - 0.5 Kb
-
-    * - ``digix``
-      - `Digistump DigiX <http://digistump.com/products/50>`_
-      - AT91SAM3X8E
-      - 84 MHz
-      - 512 Kb
-      - 28 Kb
-
-Engduino
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``engduinov1``
-      - `Engduino 1 <http://www.engduino.org>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``engduinov2``
-      - `Engduino 2 <http://www.engduino.org>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``engduinov3``
-      - `Engduino 3 <http://www.engduino.org>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-Espressif
-~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``esp01``
-      - `Espressif ESP8266 board <https://nurdspace.nl/ESP8266>`_
-      - ESP8266
-      - 80 MHz
-      - 512 Kb
-      - 32 Kb
-
-LightUp
-~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``lightup``
-      - `LightUp <https://www.lightup.io/>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-LowPowerLab
-~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``moteino``
-      - `LowPowerLab Moteino <https://lowpowerlab.com/shop/moteino-r4>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``moteinomega``
-      - `LowPowerLab MoteinoMEGA <http://lowpowerlab.com/blog/2014/08/09/moteinomega-available-now/>`_
-      - ATMEGA1284P
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb
-
-Microduino
-~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``1284p16m``
-      - `Microduino Core+ (ATmega1284P@16M,5V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
-      - ATMEGA1284P
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``1284p8m``
-      - `Microduino Core+ (ATmega1284P@8M,3.3V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
-      - ATMEGA1284P
-      - 8 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``168pa16m``
-      - `Microduino Core (Atmega168PA@16M,5V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
-      - ATMEGA168P
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``168pa8m``
-      - `Microduino Core (Atmega168PA@8M,3.3V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
-      - ATMEGA168P
-      - 8 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``328p16m``
-      - `Microduino Core (Atmega328P@16M,5V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``328p8m``
-      - `Microduino Core (Atmega328P@8M,3.3V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``32u416m``
-      - `Microduino Core USB (ATmega32U4@16M,5V) <https://www.microduino.cc/wiki/index.php?title=Microduino-CoreUSB>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``644pa16m``
-      - `Microduino Core+ (Atmega644PA@16M,5V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
-      - ATMEGA644P
-      - 16 MHz
-      - 64 Kb
-      - 4 Kb
-
-    * - ``644pa8m``
-      - `Microduino Core+ (Atmega644PA@8M,3.3V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
-      - ATMEGA644P
-      - 8 MHz
-      - 64 Kb
-      - 4 Kb
-
-PanStamp
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``panStampAVR``
-      - `PanStamp AVR <http://www.panstamp.com/product/panstamp-avr/>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``panStampNRG``
-      - `PanStamp NRG 1.1 <http://www.panstamp.com/product/197/>`_
-      - CC430F5137
-      - 12 MHz
-      - 32 Kb
-      - 4 Kb
-
-Quirkbot
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``quirkbot``
-      - `Quirkbot <http://quirkbot.com>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-RedBearLab
-~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``blend``
-      - `RedBearLab Blend <http://redbearlab.com/blend/>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``blendmicro16``
-      - `RedBearLab Blend Micro 3.3V/16MHz (overclock) <http://redbearlab.com/blendmicro/>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``blendmicro8``
-      - `RedBearLab Blend Micro 3.3V/8MHz <http://redbearlab.com/blendmicro/>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-RepRap
-~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``reprap_rambo``
-      - `RepRap RAMBo <http://reprap.org/wiki/Rambo>`_
-      - ATMEGA2560
-      - 16 MHz
-      - 256 Kb
-      - 8 Kb
-
-SainSmart
-~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``sainSmartDue``
-      - `SainSmart Due (Programming Port) <http://www.sainsmart.com/arduino/control-boards/sainsmart-due-atmel-sam3x8e-arm-cortex-m3-board-black.html>`_
-      - AT91SAM3X8E
-      - 84 MHz
-      - 512 Kb
-      - 32 Kb
-
-    * - ``sainSmartDueUSB``
-      - `SainSmart Due (USB Native Port) <http://www.sainsmart.com/arduino/control-boards/sainsmart-due-atmel-sam3x8e-arm-cortex-m3-board-black.html>`_
-      - AT91SAM3X8E
-      - 84 MHz
-      - 512 Kb
-      - 32 Kb
-
-Sanguino
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``sanguino_atmega12848m``
-      - `Sanguino ATmega1284p (8MHz) <https://code.google.com/p/sanguino/>`_
-      - ATMEGA1284P
-      - 8 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``sanguino_atmega1284m``
-      - `Sanguino ATmega1284p (20MHz) <https://code.google.com/p/sanguino/>`_
-      - ATMEGA1284P
-      - 20 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``sanguino_atmega1284p``
-      - `Sanguino ATmega1284p (16MHz) <https://code.google.com/p/sanguino/>`_
-      - ATMEGA1284P
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``sanguino_atmega644p``
-      - `Sanguino ATmega644P <https://code.google.com/p/sanguino/>`_
-      - ATMEGA644P
-      - 16 MHz
-      - 64 Kb
-      - 4 Kb
-
-SparkFun
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``sparkfun_digitalsandbox``
-      - `SparkFun Digital Sandbox <https://www.sparkfun.com/products/12651>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``sparkfun_fiov3``
-      - `SparkFun Fio V3 3.3V/8MHz <https://www.sparkfun.com/products/11520>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``sparkfun_makeymakey``
-      - `SparkFun Makey Makey <https://www.sparkfun.com/products/11511>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``sparkfun_megamini``
-      - `SparkFun Mega Pro Mini 3.3V <https://www.sparkfun.com/products/10743>`_
-      - ATMEGA2560
-      - 8 MHz
-      - 256 Kb
-      - 8 Kb
-
-    * - ``sparkfun_megapro16MHz``
-      - `SparkFun Mega Pro 5V/16MHz <https://www.sparkfun.com/products/11007>`_
-      - ATMEGA2560
-      - 16 MHz
-      - 256 Kb
-      - 8 Kb
-
-    * - ``sparkfun_megapro8MHz``
-      - `SparkFun Mega Pro 3.3V/8MHz <https://www.sparkfun.com/products/10744>`_
-      - ATMEGA2560
-      - 8 MHz
-      - 256 Kb
-      - 8 Kb
-
-    * - ``sparkfun_promicro16``
-      - `SparkFun Pro Micro 5V/16MHz <https://www.sparkfun.com/products/12640>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``sparkfun_promicro8``
-      - `SparkFun Pro Micro 3.3V/8MHz <https://www.sparkfun.com/products/12587>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``sparkfun_redboard``
-      - `SparkFun RedBoard <https://www.sparkfun.com/products/12757>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``uview``
-      - `SparkFun MicroView <https://www.sparkfun.com/products/12923>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-Teensy
-~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``teensy20``
-      - `Teensy 2.0 <https://www.pjrc.com/store/teensy.html>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``teensy20pp``
-      - `Teensy++ 2.0 <https://www.pjrc.com/store/teensypp.html>`_
-      - AT90USB1286
-      - 16 MHz
-      - 128 Kb
-      - 8 Kb
-
-    * - ``teensy30``
-      - `Teensy 3.0 <https://www.pjrc.com/store/teensy3.html>`_
-      - MK20DX128
-      - 48 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``teensy31``
-      - `Teensy 3.1 <https://www.pjrc.com/store/teensy31.html>`_
-      - MK20DX256
-      - 72 MHz
-      - 256 Kb
-      - 64 Kb
-
-    * - ``teensylc``
-      - `Teensy LC <http://www.pjrc.com/teensy/teensyLC.html>`_
-      - MKL26Z64
-      - 48 MHz
-      - 64 Kb
-      - 8 Kb
-
-TinyCircuits
-~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``tinyduino``
-      - `TinyCircuits TinyDuino Processor Board <https://tiny-circuits.com/tinyduino-processor-board.html>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``tinylily``
-      - `TinyCircuits TinyLily Mini Processor <https://tiny-circuits.com/tiny-lily-mini-processor.html>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-Wicked Device
-~~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``wildfirev2``
-      - `Wicked Device WildFire V2 <http://shop.wickeddevice.com/resources/wildfire/>`_
-      - ATMEGA1284P
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``wildfirev3``
-      - `Wicked Device WildFire V3 <http://shop.wickeddevice.com/resources/wildfire/>`_
-      - ATMEGA1284P
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb

docs/frameworks/cmsis.rst

@@ -1,96 +0,0 @@
-.. _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

docs/frameworks/energia.rst

@@ -1,114 +0,0 @@
-.. _framework_energia:
-
-Framework ``energia``
-=====================
-Energia framework enables pretty much anyone to start easily creating microcontroller-based projects and applications. Its easy-to-use libraries and functions provide developers of all experience levels to start blinking LEDs, buzzing buzzers and sensing sensors more quickly than ever before.
-
-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
-
-    * - ``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
-
-    * - ``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,14 +0,0 @@
-.. _frameworks:
-
-Frameworks
-==========
-
-.. toctree::
-    :maxdepth: 2
-
-    arduino
-    cmsis
-    energia
-    libopencm3
-    mbed
-    spl

docs/frameworks/libopencm3.rst

@@ -1,99 +0,0 @@
-.. _framework_libopencm3:
-
-Framework ``libopencm3``
-========================
-The libOpenCM3 framework aims to create a free/libre/open-source firmware library for various ARM Cortex-M0(+)/M3/M4 microcontrollers, including ST STM32, Ti Tiva and Stellaris, NXP LPC 11xx, 13xx, 15xx, 17xx parts, Atmel SAM3, Energy Micro EFM32 and others.
-
-For more detailed information please visit `vendor site <http://www.libopencm3.org/wiki/Main_Page>`_.
-
-.. 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.
-
-    * - :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.
-
-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
-
-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
-
-    * - ``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/mbed.rst

@@ -1,646 +0,0 @@
-.. _framework_mbed:
-
-Framework ``mbed``
-==================
-The mbed framework The mbed SDK has been designed to provide enough hardware abstraction to be intuitive and concise, yet powerful enough to build complex projects. It is built on the low-level ARM CMSIS APIs, allowing you to code down to the metal if needed. In addition to RTOS, USB and Networking libraries, a cookbook of hundreds of reusable peripheral and module libraries have been built on top of the SDK by the mbed Developer Community.
-
-For more detailed information please visit `vendor site <http://mbed.org/>`_.
-
-.. contents::
-
-Platforms
----------
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Description
-
-    * - :ref:`platform_freescalekinetis`
-      - Freescale Kinetis Microcontrollers is family of multiple hardware- and software-compatible ARM Cortex-M0+, Cortex-M4 and Cortex-M7-based MCU series. Kinetis MCUs offer exceptional low-power performance, scalability and feature integration.
-
-    * - :ref:`platform_nordicnrf51`
-      - The Nordic nRF51 Series is a family of highly flexible, multi-protocol, system-on-chip (SoC) devices for ultra-low power wireless applications. nRF51 Series devices support a range of protocol stacks including Bluetooth Smart (previously called Bluetooth low energy), ANT and proprietary 2.4GHz protocols such as Gazell.
-
-    * - :ref:`platform_nxplpc`
-      - The NXP LPC is a family of 32-bit microcontroller integrated circuits by NXP Semiconductors. The LPC chips are grouped into related series that are based around the same 32-bit ARM processor core, such as the Cortex-M4F, Cortex-M3, Cortex-M0+, or Cortex-M0. Internally, each microcontroller consists of the processor core, static RAM memory, flash memory, debugging interface, and various peripherals.
-
-    * - :ref:`platform_siliconlabsefm32`
-      - Silicon Labs EFM32 Gecko 32-bit microcontroller (MCU) family includes devices that offer flash memory configurations up to 256 kB, 32 kB of RAM and CPU speeds up to 48 MHz. Based on the powerful ARM Cortex-M core, the Gecko family features innovative low energy techniques, short wake-up time from energy saving modes and a wide selection of peripherals, making it ideal for battery operated applications and other systems requiring high performance and low-energy consumption.
-
-    * - :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.
-
-CQ Publishing
-~~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``lpc11u35_501``
-      - `CQ Publishing TG-LPC11U35-501 <https://developer.mbed.org/platforms/TG-LPC11U35-501/>`_
-      - LPC11U35
-      - 48 MHz
-      - 64 Kb
-      - 10 Kb
-
-Delta
-~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``dfcm_nnn40``
-      - `Delta DFCM-NNN40 <https://developer.mbed.org/platforms/Delta-DFCM-NNN40/>`_
-      - NRF51822
-      - 32 MHz
-      - 256 Kb
-      - 32 Kb
-
-Embedded Artists
-~~~~~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``lpc11u35``
-      - `Embedded Artists LPC11U35 QuickStart Board <https://developer.mbed.org/platforms/EA-LPC11U35/>`_
-      - LPC11U35
-      - 48 MHz
-      - 64 Kb
-      - 10 Kb
-
-    * - ``lpc4088``
-      - `Embedded Artists LPC4088 QuickStart Board <https://developer.mbed.org/platforms/EA-LPC4088/>`_
-      - LPC4088
-      - 120 MHz
-      - 512 Kb
-      - 96 Kb
-
-    * - ``lpc4088_dm``
-      - `Embedded Artists LPC4088 Display Module <https://developer.mbed.org/platforms/EA-LPC4088-Display-Module/>`_
-      - LPC4088
-      - 120 MHz
-      - 512 Kb
-      - 96 Kb
-
-Freescale
-~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``IBMEthernetKit``
-      - `Ethernet IoT Starter Kit <http://developer.mbed.org/platforms/IBMEthernetKit/>`_
-      - MK64FN1M0VLL12
-      - 120 MHz
-      - 1024 Kb
-      - 256 Kb
-
-    * - ``frdm_k20d50m``
-      - `Freescale Kinetis FRDM-K20D50M <https://developer.mbed.org/platforms/FRDM-K20D50M/>`_
-      - MK20DX128VLH5
-      - 48 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``frdm_k22f``
-      - `Freescale Kinetis FRDM-K22F <https://developer.mbed.org/platforms/FRDM-K22F/>`_
-      - MK22FN512VLH12
-      - 120 MHz
-      - 512 Kb
-      - 128 Kb
-
-    * - ``frdm_k64f``
-      - `Freescale Kinetis FRDM-K64F <https://developer.mbed.org/platforms/FRDM-K64F/>`_
-      - MK64FN1M0VLL12
-      - 120 MHz
-      - 1024 Kb
-      - 256 Kb
-
-    * - ``frdm_kl05z``
-      - `Freescale Kinetis FRDM-KL05Z <https://developer.mbed.org/platforms/FRDM-KL05Z/>`_
-      - MKL05Z32VFM4
-      - 48 MHz
-      - 32 Kb
-      - 4 Kb
-
-    * - ``frdm_kl25z``
-      - `Freescale Kinetis FRDM-KL25Z <https://developer.mbed.org/platforms/KL25Z/>`_
-      - MKL25Z128VLK4
-      - 48 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``frdm_kl46z``
-      - `Freescale Kinetis FRDM-KL46Z <https://developer.mbed.org/platforms/FRDM-KL46Z/>`_
-      - MKL46Z256VLL4
-      - 48 MHz
-      - 256 Kb
-      - 32 Kb
-
-JKSoft
-~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``wallBotBLE``
-      - `JKSoft Wallbot BLE <https://developer.mbed.org/platforms/JKSoft-Wallbot-BLE/>`_
-      - NRF51822
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb
-
-NGX Technologies
-~~~~~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``blueboard_lpc11u24``
-      - `NGX Technologies BlueBoard-LPC11U24 <https://developer.mbed.org/platforms/BlueBoard-LPC11U24/>`_
-      - LPC11U24
-      - 48 MHz
-      - 32 Kb
-      - 8 Kb
-
-NXP
-~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``lpc11u24``
-      - `NXP mbed LPC11U24 <https://developer.mbed.org/platforms/mbed-LPC11U24/>`_
-      - LPC11U24
-      - 48 MHz
-      - 32 Kb
-      - 8 Kb
-
-    * - ``lpc1549``
-      - `NXP LPCXpresso1549 <https://developer.mbed.org/platforms/LPCXpresso1549/>`_
-      - LPC1549
-      - 72 MHz
-      - 256 Kb
-      - 36 Kb
-
-    * - ``lpc1768``
-      - `NXP mbed LPC1768 <http://developer.mbed.org/platforms/mbed-LPC1768/>`_
-      - LPC1768
-      - 96 MHz
-      - 512 Kb
-      - 32 Kb
-
-Nordic
-~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``nrf51_dk``
-      - `Nordic nRF51-DK <https://developer.mbed.org/platforms/Nordic-nRF51-DK/>`_
-      - NRF51822
-      - 32 MHz
-      - 256 Kb
-      - 32 Kb
-
-    * - ``nrf51_dongle``
-      - `Nordic nRF51-Dongle <https://developer.mbed.org/platforms/Nordic-nRF51-Dongle/>`_
-      - NRF51822
-      - 32 MHz
-      - 256 Kb
-      - 32 Kb
-
-    * - ``nrf51_mkit``
-      - `Nordic nRF51822-mKIT <http://developer.mbed.org/platforms/Nordic-nRF51822/>`_
-      - NRF51822
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb
-
-Outrageous Circuits
-~~~~~~~~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``mbuino``
-      - `Outrageous Circuits mBuino <https://developer.mbed.org/platforms/Outrageous-Circuits-mBuino/>`_
-      - LPC11U24
-      - 48 MHz
-      - 32 Kb
-      - 8 Kb
-
-RedBearLab
-~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``redBearLab``
-      - `RedBearLab nRF51822 <https://developer.mbed.org/platforms/RedBearLab-nRF51822/>`_
-      - NRF51822
-      - 16 MHz
-      - 256 Kb
-      - 16 Kb
-
-    * - ``redBearLabBLENano``
-      - `RedBearLab BLE Nano <https://developer.mbed.org/platforms/RedBearLab-BLE-Nano/>`_
-      - NRF51822
-      - 16 MHz
-      - 256 Kb
-      - 16 Kb
-
-ST
-~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``disco_f051r8``
-      - `ST STM32F0DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF253215>`_
-      - STM32F051R8T6
-      - 48 MHz
-      - 64 Kb
-      - 8 Kb
-
-    * - ``disco_f100rb``
-      - `ST STM32VLDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF250863>`_
-      - STM32F100RBT6
-      - 24 MHz
-      - 128 Kb
-      - 8 Kb
-
-    * - ``disco_f303vc``
-      - `ST STM32F3DISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF254044>`_
-      - STM32F303VCT6
-      - 72 MHz
-      - 256 Kb
-      - 48 Kb
-
-    * - ``disco_f334c8``
-      - `ST 32F3348DISCOVERY <http://www.st.com/web/en/catalog/tools/PF260318>`_
-      - STM32F334C8T6
-      - 72 MHz
-      - 64 Kb
-      - 12 Kb
-
-    * - ``disco_f401vc``
-      - `ST 32F401CDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF259098>`_
-      - STM32F401VCT6
-      - 84 MHz
-      - 256 Kb
-      - 64 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_f429zi``
-      - `ST 32F429IDISCOVERY <http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1848/PF259090>`_
-      - STM32F429ZIT6
-      - 180 MHz
-      - 2048 Kb
-      - 256 Kb
-
-    * - ``disco_l053c8``
-      - `ST 32L0538DISCOVERY <http://www.st.com/web/en/catalog/tools/PF260319>`_
-      - STM32L053C8T6
-      - 32 MHz
-      - 64 Kb
-      - 8 Kb
-
-    * - ``nucleo_f030r8``
-      - `ST Nucleo F030R8 <https://developer.mbed.org/platforms/ST-Nucleo-F030R8/>`_
-      - STM32F030R8T6
-      - 48 MHz
-      - 64 Kb
-      - 8 Kb
-
-    * - ``nucleo_f070rb``
-      - `ST Nucleo F070RB <https://developer.mbed.org/platforms/ST-Nucleo-F070RB/>`_
-      - STM32F070RBT6
-      - 48 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``nucleo_f072rb``
-      - `ST Nucleo F072RB <https://developer.mbed.org/platforms/ST-Nucleo-F072RB/>`_
-      - STM32F072RBT6
-      - 48 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``nucleo_f091rc``
-      - `ST Nucleo F091RC <https://developer.mbed.org/platforms/ST-Nucleo-F091RC/>`_
-      - STM32F091RCT6
-      - 48 MHz
-      - 256 Kb
-      - 32 Kb
-
-    * - ``nucleo_f103rb``
-      - `ST Nucleo F103RB <https://developer.mbed.org/platforms/ST-Nucleo-F103RB/>`_
-      - STM32F103RBT6
-      - 72 MHz
-      - 128 Kb
-      - 20 Kb
-
-    * - ``nucleo_f302r8``
-      - `ST Nucleo F302R8 <https://developer.mbed.org/platforms/ST-Nucleo-F302R8/>`_
-      - STM32F302R8T6
-      - 72 MHz
-      - 64 Kb
-      - 16 Kb
-
-    * - ``nucleo_f303re``
-      - `ST Nucleo F303RE <http://developer.mbed.org/platforms/ST-Nucleo-F303RE/>`_
-      - STM32F303RET6
-      - 72 MHz
-      - 512 Kb
-      - 64 Kb
-
-    * - ``nucleo_f334r8``
-      - `ST Nucleo F334R8 <https://developer.mbed.org/platforms/ST-Nucleo-F334R8/>`_
-      - STM32F334R8T6
-      - 72 MHz
-      - 64 Kb
-      - 16 Kb
-
-    * - ``nucleo_f401re``
-      - `ST Nucleo F401RE <https://developer.mbed.org/platforms/ST-Nucleo-F401RE/>`_
-      - STM32F401RET6
-      - 84 MHz
-      - 512 Kb
-      - 96 Kb
-
-    * - ``nucleo_f411re``
-      - `ST Nucleo F411RE <https://developer.mbed.org/platforms/ST-Nucleo-F411RE/>`_
-      - STM32F411RET6
-      - 100 MHz
-      - 512 Kb
-      - 128 Kb
-
-    * - ``nucleo_l053r8``
-      - `ST Nucleo L053R8 <https://developer.mbed.org/platforms/ST-Nucleo-L053R8/>`_
-      - STM32L053R8T6
-      - 48 MHz
-      - 64 Kb
-      - 8 Kb
-
-    * - ``nucleo_l152re``
-      - `ST Nucleo L152RE <https://developer.mbed.org/platforms/ST-Nucleo-L152RE/>`_
-      - STM32L152RET6
-      - 32 MHz
-      - 512 Kb
-      - 80 Kb
-
-SeeedStudio
-~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``seeedTinyBLE``
-      - `SeeedStudio Seeed Tiny BLE <http://developer.mbed.org/platforms/Seeed-Tiny-BLE/>`_
-      - NRF51822
-      - 16 MHz
-      - 256 Kb
-      - 16 Kb
-
-    * - ``seeeduinoArchPro``
-      - `SeeedStudio Seeeduino-Arch-Pro <https://developer.mbed.org/platforms/Seeeduino-Arch-Pro/>`_
-      - LPC1768
-      - 96 MHz
-      - 512 Kb
-      - 32 Kb
-
-Silicon Labs
-~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``efm32gg_stk3700``
-      - `Silicon Labs EFM32GG-STK3700 (Giant Gecko) <https://developer.mbed.org/platforms/EFM32-Giant-Gecko/>`_
-      - EFM32GG990F1024
-      - 48 MHz
-      - 1024 Kb
-      - 128 Kb
-
-    * - ``efm32hg_stk3400``
-      - `Silicon Labs SLSTK3400A USB-enabled (Happy Gecko) <https://developer.mbed.org/platforms/EFM32-Happy-Gecko/>`_
-      - EFM32HG322F64
-      - 24 MHz
-      - 64 Kb
-      - 8 Kb
-
-    * - ``efm32lg_stk3600``
-      - `Silicon Labs EFM32LG-STK3600 (Leopard Gecko) <https://developer.mbed.org/platforms/EFM32-Leopard-Gecko/>`_
-      - EFM32LG990F256
-      - 48 MHz
-      - 256 Kb
-      - 32 Kb
-
-    * - ``efm32wg_stk3800``
-      - `Silicon Labs EFM32WG-STK3800 (Wonder Gecko) <https://developer.mbed.org/platforms/EFM32-Wonder-Gecko/>`_
-      - EFM32WG990F256
-      - 48 MHz
-      - 256 Kb
-      - 32 Kb
-
-    * - ``efm32zg_stk3200``
-      - `Silicon Labs EFM32ZG-STK3200 (Zero Gecko) <https://developer.mbed.org/platforms/EFM32-Zero-Gecko/>`_
-      - EFM2ZG222F32
-      - 24 MHz
-      - 32 Kb
-      - 4 Kb
-
-Solder Splash Labs
-~~~~~~~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``dipcortexm0``
-      - `Solder Splash Labs DipCortex M0 <https://developer.mbed.org/platforms/DipCortex-M0/>`_
-      - LPC11U24
-      - 50 MHz
-      - 32 Kb
-      - 8 Kb
-
-Switch Science
-~~~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``hrm1017``
-      - `Switch Science mbed HRM1017 <https://developer.mbed.org/platforms/mbed-HRM1017/>`_
-      - NRF51822
-      - 16 MHz
-      - 256 Kb
-      - 16 Kb
-
-    * - ``lpc1114fn28``
-      - `Switch Science mbed LPC1114FN28 <https://developer.mbed.org/platforms/LPC1114FN28/>`_
-      - LPC1114FN28
-      - 48 MHz
-      - 32 Kb
-      - 4 Kb
-
-Teensy
-~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``teensy31``
-      - `Teensy 3.1 <https://www.pjrc.com/store/teensy31.html>`_
-      - MK20DX256
-      - 72 MHz
-      - 256 Kb
-      - 64 Kb
-
-u-blox
-~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``ubloxc027``
-      - `u-blox C027 <https://developer.mbed.org/platforms/u-blox-C027/>`_
-      - LPC1768
-      - 96 MHz
-      - 512 Kb
-      - 32 Kb

docs/frameworks/spl.rst

@@ -1,96 +0,0 @@
-.. _framework_spl:
-
-Framework ``spl``
-=================
-The ST Standard Peripheral Library provides a set of functions for handling the peripherals on the STM32 Cortex-M3 family. The idea is to save the user (the new user, in particular) having to deal directly with the registers.
-
-For more detailed information please visit `vendor site <http://www.st.com/web/en/catalog/tools/FM147/CL1794/SC961/SS1743?sc=stm32embeddedsoftware>`_.
-
-.. 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

docs/history.rst

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

docs/ide.rst

@@ -1,17 +0,0 @@
-.. _ide:
-
-IDE Integration
-===============
-
-.. toctree::
-    :maxdepth: 2
-
-    ide/arduino
-    ide/atom
-    ide/clion
-    ide/eclipse
-    ide/energia
-    ide/qtcreator
-    ide/sublimetext
-    ide/vim
-    ide/visualstudio

docs/ide/arduino.rst

@@ -1,30 +0,0 @@
-.. _ide_arduino:
-
-Arduino
-=======
-
-The open-source `Arduino Software (IDE) <http://arduino.cc/en/main/software>`_
-makes it easy to write code and upload it to the board. It runs on *Windows,
-Mac OS X, and Linux*. The environment is written in *Java* and based on
-*Processing* and other open-source software.
-
-This software can be used with:
-
-* :ref:`platform_atmelavr`
-* :ref:`platform_atmelsam`
-* :ref:`framework_arduino`
-
-Refer to the `Arduino Getting Started <http://arduino.cc/en/Guide/HomePage>`_
-page for Installation instructions.
-
-Integration
------------
-
-More detailed information is located in PlatformIO blog:
-`Integration of PlatformIO library manager to Arduino IDE <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_.
-
-Screenshot
-----------
-
-.. image:: ../_static/ide-platformio-arduino.png
-    :target: http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides

docs/ide/atom.rst

@@ -1,39 +0,0 @@
-.. _ide_atom:
-
-Atom
-====
-
-`Atom <https://atom.io>`_ is a text editor that's modern, approachable,
-yet hackable to the core—a tool you can customize to do anything but also use
-productively without ever touching a config file.
-
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
-Refer to the `Atom Documentation <https://atom.io/docs>`_
-page for more detailed information.
-
-.. contents::
-
-Integration
------------
-
-Using `Atom Packages <https://atom.io/docs/v1.0.2/using-atom-atom-packages>`_
-please install `platomformio <https://atom.io/packages/platomformio>`_ package.
-
-Screenshot
-----------
-
-Building
-^^^^^^^^
-
-.. image:: ../_static/ide-platformio-atom-1.gif
-    :target: https://atom.io/packages/platomformio
-
-Uploading
-^^^^^^^^^
-
-.. image:: ../_static/ide-platformio-atom-2.gif
-    :target: https://atom.io/packages/platomformio

docs/ide/clion.rst

@@ -1,69 +0,0 @@
-.. _ide_clion:
-
-CLion
-=====
-
-The `CLion <https://www.jetbrains.com/clion/>`_ is a cross-platform C/C++ IDE
-for Linux, OS X, and Windows integrated with the CMake build system. The
-initial version will support the GCC and Clang compilers and GDB debugger.
-Clion includes such features as a smart editor, code quality assurance,
-automated refactorings, project manager, integrated version control systems.
-
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
-Refer to the `CDT Documentation <https://www.jetbrains.com/clion/documentation/>`_
-page for more detailed information.
-
-.. contents::
-
-Integration
------------
-
-Project Generator
-^^^^^^^^^^^^^^^^^
-
-Since PlatformIO 2.0 you can generate CLion compatible project using
-:option:`platformio init --ide` command. Please choose board type using
-:ref:`cmd_boards` command and run:
-
-.. code-block:: shell
-
-    platformio init --ide clion --board %TYPE%
-
-Then:
-
-1. Import this project via ``Menu: File > Import Project``
-   and specify root directory where is located :ref:`projectconf`
-2. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
-3. Build project: ``Menu: Run > Build``.
-
-There are 3 predefined targets for building:
-
-* ``PLATFORMIO_BUILD`` - build project without auto-uploading
-* ``PLATFORMIO_UPLOAD`` - build and upload (if no errors)
-* ``PLATFORMIO_CLEAN`` - clean compiled objects and etc.
-
-.. warning::
-    CLion is still in the development stage, so some of the features (like,
-    auto-complete) probably will not work with PlatformIO. See
-    `CLion issue #CPP-3977 <https://youtrack.jetbrains.com/issue/CPP-3977>`_.
-
-    Active discussion located in
-    `PlatformIO issue #132 <https://github.com/platformio/platformio/issues/132>`_.
-
-Screenshot
-----------
-
-.. image:: ../_static/ide-platformio-clion.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-clion.png
-
-Examples
---------
-
-"Blink" Project
-^^^^^^^^^^^^^^^
-
-Source code of `CLion "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/clion>`_.

docs/ide/eclipse.rst

@@ -1,67 +0,0 @@
-.. _ide_eclipse:
-
-Eclipse
-=======
-
-The `Eclipse CDT (C/C++ Development Tooling) <https://eclipse.org/cdt/>`_
-Project provides a fully functional C and C++ Integrated Development
-Environment based on the Eclipse platform. Features include: support for
-project creation and managed build for various toolchains, standard make
-build, source navigation, various source knowledge tools, such as type
-hierarchy, call graph, include browser, macro definition browser, code editor
-with syntax highlighting, folding and hyperlink navigation, source code
-refactoring and code generation, visual debugging tools, including memory,
-registers, and disassembly viewers.
-
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
-Refer to the `CDT Documentation <https://eclipse.org/cdt/documentation.php>`_
-page for more detailed information.
-
-.. contents::
-
-Integration
------------
-
-Project Generator
-^^^^^^^^^^^^^^^^^
-
-Since PlatformIO 2.0 you can generate Eclipse compatible project using
-:option:`platformio init --ide` command. Please choose board type using
-:ref:`cmd_boards` command and run:
-
-.. code-block:: shell
-
-    platformio init --ide eclipse --board %TYPE%
-
-Then:
-
-1. Import this project via
-   ``Menu: File > Import... > General > Existing Projects into Workspace > Next``
-   and specify root directory where is located :ref:`projectconf`
-2. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
-3. Build project: ``Menu: Project > Build Project``.
-
-
-Manual Integration
-^^^^^^^^^^^^^^^^^^
-
-* `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_
-* `Improvised MBED FRDM-K64F Eclipse/PlatformIO Setup and Software Installation <http://thomasweldon.com/tpw/courses/embeddsp/p00pcFrdmK64_eclipsePlatformioSetup.html>`_
-
-Screenshot
-----------
-
-.. image:: ../_static/ide-platformio-eclipse.png
-    :target: http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio
-
-Examples
---------
-
-"Blink" Project
-^^^^^^^^^^^^^^^
-
-Source code of `Eclipse "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/eclipse>`_.

docs/ide/energia.rst

@@ -1,30 +0,0 @@
-.. _ide_energia:
-
-Energia
-=======
-
-The open-source `Energia Software (IDE) <http://energia.nu>`_
-makes it easy to write code and upload it to the board. It runs on *Windows,
-Mac OS X, and Linux*. The environment is written in *Java* and based on
-*Processing* and other open-source software.
-
-This software can be used with:
-
-* :ref:`platform_timsp430`
-* :ref:`platform_titiva`
-* :ref:`framework_energia`
-
-Refer to the `Energia Getting Started <http://energia.nu/guide/>`_
-page for Installation instructions.
-
-Integration
------------
-
-More detailed information is located in PlatformIO blog:
-`Integration of PlatformIO library manager to Energia IDE <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_.
-
-Screenshot
------------
-
-.. image:: ../_static/ide-platformio-energia.png
-    :target: http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides

docs/ide/qtcreator.rst

@@ -1,186 +0,0 @@
-.. _ide_qtcreator:
-
-Qt Creator
-==========
-
-The `Qt Creator <https://github.com/qtproject/qt-creator>`_ is an open source cross-platform integrated development environment. The editor includes such features as syntax highlighting for various languages, project manager, integrated version control systems, rapid code navigation tools and code autocompletion.
-
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
-Refer to the `Qt-creator Manual <http://doc.qt.io/qtcreator/>`_
-page for more detailed information.
-
-.. contents::
-
-Integration
------------
-
-.. note::
-    Please verify that folder where is located ``platformio`` program is added
-    to `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_ environment
-    variable. See FAQ: :ref:`faq_troubleshooting_pionotfoundinpath`.
-
-Project Generator
-^^^^^^^^^^^^^^^^^
-
-Since PlatformIO 2.0 you can generate Qt Creator compatible project using
-:option:`platformio init --ide` command. Please choose board type using
-:ref:`cmd_boards` command and run:
-
-.. code-block:: shell
-
-    platformio init --ide qtcreator --board %TYPE%
-
-Then:
-
-1. Import project via ``File > Open File or Project`` and select
-   ``platformio.pro`` from the folder where is located :ref:`projectconf`
-2. Select default desktop kit and click on ``Configure Project`` (``Projects``
-   mode, left panel)
-3. Set ``General > Build directory`` to the project directory where
-   is located :ref:`projectconf`
-4. Remove all items from ``Build Steps``, click on
-   ``Build Steps > Add Build Step > Custom Process Step`` and set:
-
-   * **Command**: ``platformio``
-   * **Arguments**: ``-f -c qtcreator run``
-   * **Working directory**: ``%{buildDir}``
-
-5. Remove all items from ``Clean Steps``, click on
-   ``Clean Steps > Add Clean Step > Custom Process Step`` and set:
-
-   * **Command**: ``platformio``
-   * **Arguments**: ``-f -c qtcreator run --target clean``
-   * **Working directory**: ``%{buildDir}``
-
-6. Update ``PATH`` in ``Build Environment > PATH > EDIT`` with the result of
-   this command (paste in Terminal):
-
-.. code-block:: shell
-
-    # Linux, Mac
-    echo $PATH
-
-    # Windows
-    echo %PATH%
-
-7. Switch to ``Edit`` mode (left panel) and open source file from ``src``
-   directory (``*.c, *.cpp, *.ino, etc.``)
-8. Build project: ``Menu: Build > Build All``.
-
-.. image:: ../_static/ide-platformio-qtcreator-3.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-3.png
-
-Manual Integration
-^^^^^^^^^^^^^^^^^^
-
-Setup New Project
-~~~~~~~~~~~~~~~~~
-
-First of all, let's create new project from Qt Creator Start Page: ``New Project`` or using ``Menu: File > New File or Project``, then select project with ``Empty Qt Project`` type (``Other Project > Empty Qt Project``), fill ``Name``, ``Create in``.
-
-.. image:: ../_static/ide-platformio-qtcreator-1.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-1.png
-
-On the next steps select any available kit and click Finish button.
-
-.. image:: ../_static/ide-platformio-qtcreator-2.png
-
-Secondly, we need to delete default build and clean steps and configure project with PlatformIO source code builder (click on Projects label on left menu or ``Ctrl+5`` shortcut):
-
-.. image:: ../_static/ide-platformio-qtcreator-3.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-3.png
-
-Thirdly, change project file by adding path to directories with header files. Please edit project file to match the following contents:
-
-.. code-block:: none
-
-    win32 {
-        HOMEDIR += $$(USERPROFILE)
-    }
-    else {
-        HOMEDIR += $$(HOME)
-    }
-
-    INCLUDEPATH += "$${HOMEDIR}/.platformio/packages/framework-arduinoavr/cores/arduino"
-    INCLUDEPATH += "$${HOMEDIR}/.platformio/packages/toolchain-atmelavr/avr/include"
-
-.. image:: ../_static/ide-platformio-qtcreator-4.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-4.png
-
-First program in Qt Creator
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Simple "Blink" project will consist from two files:
-1. In the console, navigate to the root of your project folder and initialize platformio project with ``platformio init``
-2. The main "C" source file named ``main.c`` must be located in the ``src`` directory.
-Let's create new text file named ``main.c`` using ``Menu: New File or Project > General > Text File``:
-
-.. image:: ../_static/ide-platformio-qtcreator-5.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-5.png
-
-Copy the source code which is described below to file ``main.c``.
-
-.. code-block:: c
-
-    #include "Arduino.h"
-    #define WLED    13  // Most Arduino boards already have an LED attached to pin 13 on the board itself
-
-    void setup()
-    {
-      pinMode(WLED, OUTPUT);  // set pin as output
-    }
-
-    void loop()
-    {
-      digitalWrite(WLED, HIGH);  // set the LED on
-      delay(1000);               // wait for a second
-      digitalWrite(WLED, LOW);   // set the LED off
-      delay(1000);               // wait for a second
-    }
-
-3. Locate the project configuration file named ``platformio.ini`` at the root of the project directory and open it.
-
-.. image:: ../_static/ide-platformio-qtcreator-6.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-6.png
-
-Edit the content to match the code described below.
-
-.. code-block:: none
-
-    #
-    # Project Configuration File
-    #
-    # A detailed documentation with the EXAMPLES is located here:
-    # http://docs.platformio.org/en/latest/projectconf.html
-    #
-
-    # A sign `#` at the beginning of the line indicates a comment
-    # Comment lines are ignored.
-
-    [env:arduino_uno]
-    platform = atmelavr
-    framework = arduino
-    board = uno
-
-Conclusion
-~~~~~~~~~~
-
-Taking everything into account, we can build project with shortcut ``Ctrl+Shift+B`` or using ``Menu: Build > Build All``.
-
-Screenshot
-----------
-
-.. image:: ../_static/ide-platformio-qtcreator-7.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-7.png
-
-Examples
---------
-
-"Blink" Project
-^^^^^^^^^^^^^^^
-
-Source code of `Qt Creator "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/qtcreator>`_.

docs/ide/sublimetext.rst

@@ -1,168 +0,0 @@
-.. _ide_sublimetext:
-
-Sublime Text
-============
-
-The `Sublime Text <http://www.sublimetext.com/>`_ is a cross-platform text and source code editor, with a Python application programming interface (API). Sublime Text is proprietary software. Its functionality is extendable with plugins. Most of the extending packages have free-software licenses and are community-built and maintained. Sublime Text lacks graphical setting dialogues and is entirely configured by editing text files.
-
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
-Refer to the `Sublime Text Documentation <http://docs.sublimetext.info/en/latest>`_
-page for more detailed information.
-
-.. contents::
-
-Integration
------------
-
-Project Generator
-^^^^^^^^^^^^^^^^^
-
-Since PlatformIO 2.0 you can generate Sublime Text compatible project using
-:option:`platformio init --ide` command. Please choose board type using
-:ref:`cmd_boards` command and run:
-
-.. code-block:: shell
-
-    platformio init --ide sublimetext --board %TYPE%
-
-Then:
-
-1. Import project via ``Menu: Project > Open Project...`` and select
-   ``platformio.sublime-project`` from the folder where is located :ref:`projectconf`
-2. Select PlatformIO as build system: ``Menu: Tools > Build System > PlatformIO``
-3. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
-4. Build project: ``Menu: Tools > Build``.
-
-
-Manual Integration
-^^^^^^^^^^^^^^^^^^
-
-.. note::
-    Please verify that folder where is located ``platformio`` program is added
-    to `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_ environment
-    variable. See FAQ: :ref:`faq_troubleshooting_pionotfoundinpath`.
-
-Initial configuration
-~~~~~~~~~~~~~~~~~~~~~
-
-First of all, we need to create "New Build System" with name "PlatformIO"
-from ``Menu: Tools > Build System > New Build System`` and fill it like
-described below:
-
-.. code-block:: bash
-
-    {
-        "cmd": ["platformio", "-f", "-c", "sublimetext", "run"],
-        "working_dir": "${project_path:${folder}}",
-        "variants":
-        [
-            {
-                "name": "Clean",
-                "cmd": ["platformio", "-f", "-c", "sublimetext", "run", "--target", "clean"]
-            },
-            {
-                "name": "Upload",
-                "cmd": ["platformio", "-f", "-c", "sublimetext", "run", "--target", "upload"]
-            }
-        ]
-    }
-
-Secondly, we need to select "PlatformIO" Build System from a list:
-
-.. image:: ../_static/ide-sublime-text-platformio-newproject-2.png
-
-After that, we can use the necessary commands from
-``Menu: Tools > Command Palette`` or with ``Ctrl+Shift+P`` (Windows/Linux)
-``Cmd+Shift+P`` (Mac) shortcut.
-
-.. image:: ../_static/ide-sublime-text-platformio-newproject-3.png
-
-Command Hotkeys
-'''''''''''''''
-
-Sublime Text allows to bind own hotkey per command. Let's setup them
-for PlatformIO commands using shortcut ``Menu: Preferences > Key-Bindings - User``:
-
-.. image:: ../_static/ide-sublime-text-platformio-newproject-4.png
-
-We are going to use these shortcuts:
-
-* ``F11`` for clean project
-* ``F12`` for upload firmware to target device
-
-In this case, the final code will look like:
-
-.. code-block:: none
-
-    [
-        { "keys": ["f11"], "command": "build", "args": {"variant": "Clean"} },
-        { "keys": ["f12"], "command": "build", "args": {"variant": "Upload"} }
-    ]
-
-First program in Sublime Text
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Simple "Blink" project will consist from two files:
-
-1. Main "C" source file named ``main.c`` must be located in the ``src`` directory.
-Let's create new file named ``main.c`` using ``Menu: File > New File`` or shortcut ``Ctrl+N`` (Windows/Linux) ``Cmd+N`` (Mac) with the next contents:
-
-.. code-block:: c
-
-    #include "Arduino.h"
-    #define WLED    13  // Most Arduino boards already have an LED attached to pin 13 on the board itself
-
-    void setup()
-    {
-      pinMode(WLED, OUTPUT);  // set pin as output
-    }
-
-    void loop()
-    {
-      digitalWrite(WLED, HIGH);  // set the LED on
-      delay(1000);               // wait for a second
-      digitalWrite(WLED, LOW);   // set the LED off
-      delay(1000);               // wait for a second
-    }
-
-2. Project Configuration File named ``platformio.ini`` must be located in the project root directory.
-Copy the source code which is described below to it.
-
-.. code-block:: none
-
-    #
-    # Project Configuration File
-    #
-    # A detailed documentation with the EXAMPLES is located here:
-    # http://docs.platformio.org/en/latest/projectconf.html
-    #
-
-    # A sign `#` at the beginning of the line indicates a comment
-    # Comment lines are ignored.
-
-    [env:arduino_uno]
-    platform = atmelavr
-    framework = arduino
-    board = uno
-
-Conclusion
-~~~~~~~~~~
-
-Taking everything into account, we can open project directory in Sublime Text using ``Menu: File > Open Folder`` and build it with shortcut ``Ctrl+B`` (Windows/Linux) or ``Cmd+B`` (Mac), clean project with shortcut ``F11`` and upload firmware to target with shortcut ``F12``.
-
-Screenshot
-----------
-
-.. image:: ../_static/ide-sublime-text-platformio-newproject-5.png
-
-Examples
---------
-
-"Blink" Project
-^^^^^^^^^^^^^^^
-
-Source code of `Sublime Text "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/sublimetext>`_.

docs/ide/vim.rst

@@ -1,51 +0,0 @@
-.. _ide_vim:
-
-VIM
-===
-
-`VIM <http://www.vim.org/>`_ is an open-source, powerful and configurable text
-editor. Vim is designed for use both from a command-line interface and as a
-standalone application in a graphical user interface.
-
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
-Integration
------------
-
-.. note::
-    Please verify that folder where is located ``platformio`` program is added
-    to `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_ environment
-    variable. See FAQ: :ref:`faq_troubleshooting_pionotfoundinpath`.
-
-Recommended bundles:
-
-* Syntax highlight - `Arduino-syntax-file <https://github.com/vim-scripts/Arduino-syntax-file>`_
-* Code Completion - `YouCompleteMe <https://github.com/Valloric/YouCompleteMe>`_ (see configuration example by **Anthony Ford** `PlatformIO/YouCompleteMe Integration <https://gist.github.com/ajford/f551b2b6fd4d6b6e1ef2>`_)
-* Syntax checking - `Syntastic <https://github.com/scrooloose/syntastic>`_
-
-Put to the project directory ``Makefile`` wrapper with contents:
-
-.. code-block:: make
-
-    # Uncomment lines below if you have problems with $PATH
-    #SHELL := /bin/bash
-    #PATH := /usr/local/bin:$(PATH)
-
-    all:
-        platformio -f -c vim run --target upload
-
-    clean:
-        platformio -f -c vim run --target clean
-
-
-Now, in VIM ``cd /path/to/this/project`` and press ``Ctrl+B`` or ``Cmd+B``
-(Mac). *PlatformIO* should compile your source code from the ``src`` directory,
-make firmware and upload it.
-
-Screenshot
-----------
-
-.. image:: ../_static/ide-platformio-vim.png

docs/ide/visualstudio.rst

@@ -1,146 +0,0 @@
-.. _ide_visualstudio:
-
-Visual Studio
-=============
-
-The `Microsoft Visual Studio (Free) <http://visualstudio.com/free>`_ is an integrated development environment (IDE) from Microsoft. Visual Studio includes a code editor supporting IntelliSense (the code completion component) as well as code refactoring.
-
-This software can be used with:
-
-* all available :ref:`platforms`
-* all available :ref:`frameworks`
-
-Refer to the `Visual Studio Documentation <https://msdn.microsoft.com/library/vstudio>`_
-page for more detailed information.
-
-.. contents::
-
-Integration
------------
-
-.. note::
-    Please verify that folder where is located ``platformio`` program is added
-    to `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_ environment
-    variable. See FAQ: :ref:`faq_troubleshooting_pionotfoundinpath`.
-
-Project Generator
-^^^^^^^^^^^^^^^^^
-
-Since PlatformIO 2.0 you can generate Visual Studio compatible project using
-:option:`platformio init --ide` command. Please choose board type using
-:ref:`cmd_boards` command and run:
-
-.. code-block:: shell
-
-    platformio init --ide visualstudio --board %TYPE%
-
-Then:
-
-1. Import this project via ``Menu: File > Open > Project/Solution``
-   and specify root directory where is located :ref:`projectconf`
-2. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
-3. Build project: ``Menu: Build > Build Solution``.
-
-Manual Integration
-^^^^^^^^^^^^^^^^^^
-
-Setup New Project
-~~~~~~~~~~~~~~~~~
-
-First of all, let's create new project from Visual Studio Start Page: ``Start > New Project`` or using ``Menu: File > New > Project``, then select project with ``Makefile`` type (``Visual C++ > General > Makefile Project``), fill ``Project name``, ``Solution name``, ``Location`` fields and press OK button.
-
-.. image:: ../_static/ide-vs-platformio-newproject.png
-
-Secondly, we need to configure project with PlatformIO source code builder:
-
-.. image:: ../_static/ide-vs-platformio-newproject-2.png
-
-If we want to use native AVR programming, we have to specify additional preprocessor symbol ("Preprocessor definitions" field) about your MCU. For example, an Arduino Uno is based on the ATmega328 MCU. In this case We will add new definition  ``__AVR_ATmega328__``.
-
-.. image:: ../_static/ide-vs-platformio-newproject-2-1.png
-
-Release Configuration is the same as Debug, so on the next step we check "Same as Debug Configuration" and click "Finish" button.
-
-.. image:: ../_static/ide-vs-platformio-newproject-3.png
-
-Thirdly, we need to add directories with header files using project properties (right click on the project name or ``Alt-Enter`` shortcut) and add two directories to ``Configuration Properties > NMake > Include Search Path``:
-
-.. code-block:: none
-
-    $(HOMEDRIVE)$(HOMEPATH)\.platformio\packages\toolchain-atmelavr\avr\include
-    $(HOMEDRIVE)$(HOMEPATH)\.platformio\packages\framework-arduinoavr\cores\arduino
-
-.. image:: ../_static/ide-vs-platformio-newproject-5.png
-
-First program in Visual Studio
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Simple "Blink" project will consist from two files:
-
-1. Main "C" source file named ``main.c`` must be located in the ``src`` directory.
-Let's create new file named ``main.c`` using ``Menu: File > New File`` or shortcut ``Ctrl+N``:
-
-.. image:: ../_static/ide-vs-platformio-newproject-6.png
-
-Copy the source code which is described below to file ``main.c``.
-
-.. code-block:: c
-
-    #include "Arduino.h"
-    #define WLED    13  // Most Arduino boards already have an LED attached to pin 13 on the board itself
-
-    void setup()
-    {
-      pinMode(WLED, OUTPUT);  // set pin as output
-    }
-
-    void loop()
-    {
-      digitalWrite(WLED, HIGH);  // set the LED on
-      delay(1000);               // wait for a second
-      digitalWrite(WLED, LOW);   // set the LED off
-      delay(1000);               // wait for a second
-    }
-
-2. Project Configuration File named ``platformio.ini`` must be located in the project root directory.
-
-.. image:: ../_static/ide-vs-platformio-newproject-7.png
-
-Copy the source code which is described below to it.
-
-.. code-block:: none
-
-    #
-    # Project Configuration File
-    #
-    # A detailed documentation with the EXAMPLES is located here:
-    # http://docs.platformio.org/en/latest/projectconf.html
-    #
-
-    # A sign `#` at the beginning of the line indicates a comment
-    # Comment lines are ignored.
-
-    [env:arduino_uno]
-    platform = atmelavr
-    framework = arduino
-    board = uno
-
-
-Conclusion
-~~~~~~~~~~
-
-Taking everything into account, we can build project with shortcut ``Ctrl+Shift+B`` or using ``Menu: Build > Build Solution``.
-
-Screenshot
-----------
-
-.. image:: ../_static/ide-vs-platformio-newproject-8.png
-    :target: http://docs.platformio.org/en/latest/_static/ide-vs-platformio-newproject-8.png
-
-Examples
---------
-
-"Blink" Project
-^^^^^^^^^^^^^^^
-
-Source code of `Visual Studio "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/visualstudio>`_.

docs/index.rst

@@ -1,100 +0,0 @@
-PlatformIO is a cross-platform code builder and the missing library manager
-===========================================================================
-
-**Ready for embedded development, IDE and Continuous integration, Arduino and
-MBED compatible**
-
-*Atmel AVR & SAM, Espressif, Freescale Kinetis, Nordic nRF51, NXP LPC,
-Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed,
-libOpenCM3, etc.*
-
-.. image:: _static/platformio-logo.png
-    :target: http://platformio.org
-
-* `Website <http://platformio.org>`_
-* `Web 2.0 Library Search <http://platformio.org/#!/lib>`_ |
-  `Embedded Boards Explorer <http://platformio.org/#!/boards>`_
-* `Project Examples <https://github.com/platformio/platformio/tree/develop/examples>`_
-* `Source Code <https://github.com/platformio/platformio>`_ |
-  `Issues <https://github.com/platformio/platformio/issues>`_
-* `Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
-  `Reddit <http://www.reddit.com/r/platformio/>`_ |
-  `Facebook <https://www.facebook.com/platformio>`_ |
-  `Twitter <https://twitter.com/PlatformIO_Org>`_
-
-You have **no need** to install any *IDE* or compile any tool chains. *PlatformIO*
-has pre-built different development platforms and pre-configured settings for
-the most popular embedded boards. For further details, please
-refer to :ref:`faq_what_is_platformio`
-
-Embedded Development. *Easier Than Ever.*
------------------------------------------
-
-* Colourful command-line output
-* :ref:`IDE Integration <ide>` with *Arduino, Eclipse, Energia, Qt Creator,
-  Sublime Text, Vim, Visual Studio*
-* :ref:`ci` with *AppVeyor, Circle CI, Drone, Shippable, Travis CI*
-* Built-in :ref:`Serial Port Monitor <cmd_serialports_monitor>` and
-  configurable build :ref:`-flags/-options <projectconf_build_flags>`
-* Pre-built tool chains, :ref:`frameworks` for the
-  :ref:`Development Platforms <platforms>`
-
-Smart Code Builder. *Fast and Reliable.*
-----------------------------------------
-
-* Reliable, automatic dependency analysis and 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 :ref:`librarymanager`
-
-The Missing Library Manager. *It's here!*
------------------------------------------
-
-* Friendly Command-Line Interface
-* Modern `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
-* Library dependency management
-* Automatic library updating
-* It runs on Windows, Mac OS X, and Linux (+ARM).
-
-
-Contents
---------
-
-.. toctree::
-    :caption: Getting Started
-    :maxdepth: 2
-
-    demo
-    installation
-    quickstart
-    userguide/index
-
-.. toctree::
-    :caption: Configuration
-    :maxdepth: 2
-
-    projectconf
-    envvars
-
-.. toctree::
-    :caption: Instruments
-    :maxdepth: 2
-
-    Platforms & Boards <platforms/index>
-    frameworks/index
-
-.. toctree::
-    :caption: Integration
-    :maxdepth: 2
-
-    librarymanager/index
-    ci/index
-    ide
-
-.. toctree::
-    :caption: Miscellaneous
-    :maxdepth: 2
-
-    articles
-    FAQ <faq>
-    history

docs/installation.rst

@@ -1,166 +0,0 @@
-.. _installation:
-
-Installation
-============
-
-**PlatformIO** is written in `Python <https://www.python.org/downloads/>`_ and
-works on Mac OS X, Linux, Windows OS and *ARM*-based credit-card sized
-computers (`Raspberry Pi <http://www.raspberrypi.org>`_,
-`BeagleBone <http://beagleboard.org>`_,
-`CubieBoard <http://cubieboard.org>`_).
-
-.. contents::
-
-System requirements
--------------------
-
-* **Operating systems:**
-    * Mac OS X
-    * Linux, +ARM
-    * Windows
-* Python 2.6.x or Python 2.7.x(recommended)
-
-All commands below should be executed in
-`Command-line <http://en.wikipedia.org/wiki/Command-line_interface>`_
-application (Terminal):
-
-* Mac OS X / Linux – *Terminal* application
-* Windows – ``cmd.exe`` application.
-
-Installation options
---------------------
-
-.. warning::
-    **Windows OS**: Please `Download the latest Python 2.7.x
-    <https://www.python.org/downloads/>`_ and install it.
-    **DON'T FORGET** to select ``Add python.exe to Path`` feature on the
-    "Customize" stage.
-
-Please *choose one of* the following installation options:
-
-Python Package Manager
-~~~~~~~~~~~~~~~~~~~~~~
-
-The latest stable version of PlatformIO may be done via
-`pip <https://pip.pypa.io>`_ as follows:
-
-.. code-block:: bash
-
-    # update dependent packages to the latest versions
-    pip install -U pip setuptools
-
-    # install the latest version of PlatformIO
-    pip install -U platformio
-
-Note that you may run into permissions issues running these commands. You have
-a few options here:
-
-* Run with ``sudo`` to install PlatformIO and dependencies globally
-* Specify the `pip install --user <https://pip.pypa.io/en/stable/user_guide.html#user-installs>`_
-  option to install local to your user
-* Run the command in a `virtualenv <https://virtualenv.pypa.io>`_ local to a
-  specific project working set.
-
-Installer Script
-~~~~~~~~~~~~~~~~
-
-Super-Quick (Mac / Linux)
-'''''''''''''''''''''''''
-
-To install or upgrade *PlatformIO* paste that at a *Terminal* prompt
-(**MAY require** administrator access ``sudo``):
-
-.. code-block:: bash
-
-    python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
-
-
-Local Download (Mac / Linux / Windows)
-''''''''''''''''''''''''''''''''''''''
-
-To install or upgrade *PlatformIO*, download (save as...)
-`get-platformio.py <https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py>`_
-script. Then run the following (**MAY require** administrator access ``sudo``):
-
-.. code-block:: bash
-
-    # change directory to folder where is located downloaded "get-platformio.py"
-    cd /path/to/dir/where/is/located/get-platformio.py/script
-
-    # run it
-    python get-platformio.py
-
-
-On *Windows OS* it may look like:
-
-.. code-block:: bash
-
-    # change directory to folder where is located downloaded "get-platformio.py"
-    cd C:\path\to\dir\where\is\located\get-platformio.py\script
-
-    # run it
-    C:\Python27\python.exe get-platformio.py
-
-Full Guide
-~~~~~~~~~~
-
-1. Check a ``python`` version (only 2.6-2.7 is supported):
-
-.. code-block:: bash
-
-    python --version
-
-*Windows Users* only:
-
-    * `Download Python 2.7 <https://www.python.org/downloads/>`_ and install it.
-    * Add to PATH system variable ``;C:\Python27;C:\Python27\Scripts;`` and reopen *Command Prompt* (``cmd.exe``) application. Please read this article `How to set the path and environment variables in Windows <http://www.computerhope.com/issues/ch000549.htm>`_.
-
-2. Install a ``platformio`` and related packages:
-
-.. code-block:: bash
-
-    pip install -U pip setuptools
-    pip install -U platformio
-
-If your computer does not recognize ``pip`` command, try to install it first
-using `these instructions <https://pip.pypa.io/en/latest/installing.html>`_.
-
-For upgrading ``platformio`` to the latest version:
-
-.. code-block:: bash
-
-    pip install -U platformio
-
-Development Version
-~~~~~~~~~~~~~~~~~~~
-
-.. warning::
-    We don't recommend to use ``develop`` version in production.
-
-Install the latest PlatformIO from the ``develop`` branch:
-
-.. code-block:: bash
-
-    pip install -U pip setuptools
-    pip install -U https://github.com/platformio/platformio/archive/develop.zip
-
-If you want to be up-to-date with the latest ``develop`` version of PlatformIO,
-then you need to re-install PlatformIO each time if you see the new commits in
-`PlatformIO GitHub repository (branch: develop) <https://github.com/platformio/platformio/commits/develop>`_.
-
-Troubleshooting
----------------
-
-.. warning::
-    If you are going to run *PlatformIO* from **subprocess**, you
-    :ref:`MUST DISABLE <faq_troubleshooting_pioblocksprompt>` all prompts.
-    It will allow you to avoid blocking.
-
-.. note::
-    **Linux OS**: Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
-
-    **Windows OS**: Please check that you have correctly installed USB driver
-    from board manufacturer
-
-For further details, frequently questions, please refer to :ref:`faq`.

docs/librarymanager/config.rst

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

docs/librarymanager/creating.rst

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

docs/librarymanager/index.rst

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

docs/make.bat

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

docs/platforms/atmelavr.rst

@@ -1,854 +0,0 @@
-.. _platform_atmelavr:
-
-Platform ``atmelavr``
-=====================
-Atmel AVR 8- and 32-bit MCUs deliver a unique combination of performance, power efficiency and design flexibility. Optimized to speed time to market-and easily adapt to new ones-they are based on the industrys most code-efficient architecture for C and assembly programming.
-
-For more detailed information please visit `vendor site <http://www.atmel.com/products/microcontrollers/avr/default.aspx>`_.
-
-.. contents::
-
-Packages
---------
-
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Contents
-
-    * - ``toolchain-atmelavr``
-      - `avr-gcc <https://gcc.gnu.org/wiki/avr-gcc>`_, `GDB <http://www.gnu.org/software/gdb/>`_, `AVaRICE <http://avarice.sourceforge.net/>`_, `SimulAVR <http://www.nongnu.org/simulavr/>`_
-
-    * - ``tool-avrdude``
-      - `AVRDUDE <http://www.nongnu.org/avrdude/>`_
-
-    * - ``framework-arduinoavr``
-      - `Arduino Wiring-based Framework (AVR Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
-
-    * - ``tool-micronucleus``
-      - `Micronucleus <https://github.com/micronucleus/micronucleus>`_
-
-.. warning::
-    **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
-
-    **Windows Users:** Please check that you have correctly installed USB driver
-    from board manufacturer
-
-
-
-Frameworks
-----------
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Description
-
-    * - :ref:`framework_arduino`
-      - Arduino Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
-
-Boards
-------
-
-.. note::
-    * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
-    * For more detailed ``board`` information please scroll tables below by
-      horizontal.
-
-Adafruit
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``flora8``
-      - `Adafruit Flora <http://www.adafruit.com/product/659>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``gemma``
-      - `Adafruit Gemma <http://www.adafruit.com/products/1222>`_
-      - ATTINY85
-      - 8 MHz
-      - 8 Kb
-      - 0.5 Kb
-
-    * - ``protrinket3``
-      - `Adafruit Pro Trinket 3V/12MHz (USB) <http://www.adafruit.com/products/2010>`_
-      - ATMEGA328P
-      - 12 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``protrinket3ftdi``
-      - `Adafruit Pro Trinket 3V/12MHz (FTDI) <http://www.adafruit.com/products/2010>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``protrinket5``
-      - `Adafruit Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``protrinket5ftdi``
-      - `Adafruit Pro Trinket 5V/16MHz (USB) <http://www.adafruit.com/products/2000>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``trinket3``
-      - `Adafruit Trinket 3V/8MHz <http://www.adafruit.com/products/1500>`_
-      - ATTINY85
-      - 8 MHz
-      - 8 Kb
-      - 0.5 Kb
-
-    * - ``trinket5``
-      - `Adafruit Trinket 5V/16MHz <http://www.adafruit.com/products/1501>`_
-      - ATTINY85
-      - 16 MHz
-      - 8 Kb
-      - 0.5 Kb
-
-Arduino
-~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``LilyPadUSB``
-      - `Arduino LilyPad USB <http://arduino.cc/en/Main/ArduinoBoardLilyPadUSB>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``atmegangatmega168``
-      - `Arduino NG or older ATmega168 <http://arduino.cc/en/main/boards>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``atmegangatmega8``
-      - `Arduino NG or older ATmega8 <http://arduino.cc/en/main/boards>`_
-      - ATMEGA8
-      - 16 MHz
-      - 8 Kb
-      - 1 Kb
-
-    * - ``btatmega168``
-      - `Arduino BT ATmega168 <http://arduino.cc/en/main/boards>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``btatmega328``
-      - `Arduino BT ATmega328 <http://arduino.cc/en/main/boards>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``diecimilaatmega168``
-      - `Arduino Duemilanove or Diecimila ATmega168 <http://arduino.cc/en/Main/ArduinoBoardDiecimila>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``diecimilaatmega328``
-      - `Arduino Duemilanove or Diecimila ATmega328 <http://arduino.cc/en/Main/ArduinoBoardDiecimila>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``esplora``
-      - `Arduino Esplora <http://arduino.cc/en/Main/ArduinoBoardEsplora>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``ethernet``
-      - `Arduino Ethernet <http://arduino.cc/en/Main/ArduinoBoardEthernet>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``fio``
-      - `Arduino Fio <http://arduino.cc/en/Main/ArduinoBoardFio>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``leonardo``
-      - `Arduino Leonardo <http://arduino.cc/en/Main/arduinoBoardLeonardo>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``lilypadatmega168``
-      - `Arduino LilyPad ATmega168 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
-      - ATMEGA168
-      - 8 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``lilypadatmega328``
-      - `Arduino LilyPad ATmega328 <http://arduino.cc/en/Main/ArduinoBoardLilyPad>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``megaADK``
-      - `Arduino Mega ADK <http://arduino.cc/en/Main/ArduinoBoardMegaADK>`_
-      - ATMEGA2560
-      - 16 MHz
-      - 256 Kb
-      - 8 Kb
-
-    * - ``megaatmega1280``
-      - `Arduino Mega or Mega 2560 ATmega1280 <http://arduino.cc/en/Main/arduinoBoardMega>`_
-      - ATMEGA1280
-      - 16 MHz
-      - 128 Kb
-      - 8 Kb
-
-    * - ``megaatmega2560``
-      - `Arduino Mega or Mega 2560 ATmega2560 (Mega 2560) <http://arduino.cc/en/Main/arduinoBoardMega2560>`_
-      - ATMEGA2560
-      - 16 MHz
-      - 256 Kb
-      - 8 Kb
-
-    * - ``micro``
-      - `Arduino Micro <http://arduino.cc/en/Main/ArduinoBoardMicro>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``miniatmega168``
-      - `Arduino Mini ATmega168 <http://arduino.cc/en/Main/ArduinoBoardMini>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``miniatmega328``
-      - `Arduino Mini ATmega328 <http://arduino.cc/en/Main/ArduinoBoardMini>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``nanoatmega168``
-      - `Arduino Nano ATmega168 <http://arduino.cc/en/Main/ArduinoBoardNano>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``nanoatmega328``
-      - `Arduino Nano ATmega328 <http://arduino.cc/en/Main/ArduinoBoardNano>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``pro16MHzatmega168``
-      - `Arduino Pro or Pro Mini ATmega168 (5V, 16 MHz) <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
-      - ATMEGA168
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``pro16MHzatmega328``
-      - `Arduino Pro or Pro Mini ATmega328 (5V, 16 MHz) <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``pro8MHzatmega168``
-      - `Arduino Pro or Pro Mini ATmega168 (3.3V, 8 MHz) <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
-      - ATMEGA168
-      - 8 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``pro8MHzatmega328``
-      - `Arduino Pro or Pro Mini ATmega328 (3.3V, 8 MHz) <http://arduino.cc/en/Main/ArduinoBoardProMini>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``robotControl``
-      - `Arduino Robot Control <http://arduino.cc/en/Main/Robot>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``robotMotor``
-      - `Arduino Robot Motor <http://arduino.cc/en/Main/Robot>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``uno``
-      - `Arduino Uno <http://arduino.cc/en/Main/ArduinoBoardUno>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``yun``
-      - `Arduino Yun <http://arduino.cc/en/Main/ArduinoBoardYun>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-BQ
-~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``zumbt328``
-      - `BQ ZUM BT-328 board <http://www.bq.com/gb/products/zum.html>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-BitWizard
-~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``raspduino``
-      - `BitWizard Raspduino <http://www.bitwizard.nl/wiki/index.php/Raspduino>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-Digistump
-~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``digispark-pro``
-      - `Digistump Digispark Pro (Default 16 MHz) <http://digistump.com/products/109>`_
-      - ATTINY167
-      - 16 MHz
-      - 16 Kb
-      - 0.5 Kb
-
-    * - ``digispark-pro32``
-      - `Digistump Digispark Pro (16 MHz) (32 byte buffer) <http://digistump.com/products/109>`_
-      - ATTINY167
-      - 16 MHz
-      - 16 Kb
-      - 0.5 Kb
-
-    * - ``digispark-pro64``
-      - `Digistump Digispark Pro (16 MHz) (64 byte buffer) <http://digistump.com/products/109>`_
-      - ATTINY167
-      - 16 MHz
-      - 16 Kb
-      - 0.5 Kb
-
-    * - ``digispark-tiny``
-      - `Digistump Digispark (Default - 16 MHz) <http://digistump.com/products/1>`_
-      - ATTINY85
-      - 16 MHz
-      - 8 Kb
-      - 0.5 Kb
-
-Engduino
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``engduinov1``
-      - `Engduino 1 <http://www.engduino.org>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``engduinov2``
-      - `Engduino 2 <http://www.engduino.org>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``engduinov3``
-      - `Engduino 3 <http://www.engduino.org>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-LightUp
-~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``lightup``
-      - `LightUp <https://www.lightup.io/>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-LowPowerLab
-~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``moteino``
-      - `LowPowerLab Moteino <https://lowpowerlab.com/shop/moteino-r4>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``moteinomega``
-      - `LowPowerLab MoteinoMEGA <http://lowpowerlab.com/blog/2014/08/09/moteinomega-available-now/>`_
-      - ATMEGA1284P
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb
-
-Microduino
-~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``1284p16m``
-      - `Microduino Core+ (ATmega1284P@16M,5V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
-      - ATMEGA1284P
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``1284p8m``
-      - `Microduino Core+ (ATmega1284P@8M,3.3V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
-      - ATMEGA1284P
-      - 8 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``168pa16m``
-      - `Microduino Core (Atmega168PA@16M,5V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
-      - ATMEGA168P
-      - 16 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``168pa8m``
-      - `Microduino Core (Atmega168PA@8M,3.3V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
-      - ATMEGA168P
-      - 8 MHz
-      - 16 Kb
-      - 1 Kb
-
-    * - ``328p16m``
-      - `Microduino Core (Atmega328P@16M,5V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``328p8m``
-      - `Microduino Core (Atmega328P@8M,3.3V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``32u416m``
-      - `Microduino Core USB (ATmega32U4@16M,5V) <https://www.microduino.cc/wiki/index.php?title=Microduino-CoreUSB>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``644pa16m``
-      - `Microduino Core+ (Atmega644PA@16M,5V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
-      - ATMEGA644P
-      - 16 MHz
-      - 64 Kb
-      - 4 Kb
-
-    * - ``644pa8m``
-      - `Microduino Core+ (Atmega644PA@8M,3.3V) <https://www.microduino.cc/wiki/index.php?title=Microduino-Core%2B>`_
-      - ATMEGA644P
-      - 8 MHz
-      - 64 Kb
-      - 4 Kb
-
-PanStamp
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``panStampAVR``
-      - `PanStamp AVR <http://www.panstamp.com/product/panstamp-avr/>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-Quirkbot
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``quirkbot``
-      - `Quirkbot <http://quirkbot.com>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-RedBearLab
-~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``blend``
-      - `RedBearLab Blend <http://redbearlab.com/blend/>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``blendmicro16``
-      - `RedBearLab Blend Micro 3.3V/16MHz (overclock) <http://redbearlab.com/blendmicro/>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``blendmicro8``
-      - `RedBearLab Blend Micro 3.3V/8MHz <http://redbearlab.com/blendmicro/>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-RepRap
-~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``reprap_rambo``
-      - `RepRap RAMBo <http://reprap.org/wiki/Rambo>`_
-      - ATMEGA2560
-      - 16 MHz
-      - 256 Kb
-      - 8 Kb
-
-Sanguino
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``sanguino_atmega12848m``
-      - `Sanguino ATmega1284p (8MHz) <https://code.google.com/p/sanguino/>`_
-      - ATMEGA1284P
-      - 8 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``sanguino_atmega1284m``
-      - `Sanguino ATmega1284p (20MHz) <https://code.google.com/p/sanguino/>`_
-      - ATMEGA1284P
-      - 20 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``sanguino_atmega1284p``
-      - `Sanguino ATmega1284p (16MHz) <https://code.google.com/p/sanguino/>`_
-      - ATMEGA1284P
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``sanguino_atmega644p``
-      - `Sanguino ATmega644P <https://code.google.com/p/sanguino/>`_
-      - ATMEGA644P
-      - 16 MHz
-      - 64 Kb
-      - 4 Kb
-
-SparkFun
-~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``sparkfun_digitalsandbox``
-      - `SparkFun Digital Sandbox <https://www.sparkfun.com/products/12651>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``sparkfun_fiov3``
-      - `SparkFun Fio V3 3.3V/8MHz <https://www.sparkfun.com/products/11520>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``sparkfun_makeymakey``
-      - `SparkFun Makey Makey <https://www.sparkfun.com/products/11511>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``sparkfun_megamini``
-      - `SparkFun Mega Pro Mini 3.3V <https://www.sparkfun.com/products/10743>`_
-      - ATMEGA2560
-      - 8 MHz
-      - 256 Kb
-      - 8 Kb
-
-    * - ``sparkfun_megapro16MHz``
-      - `SparkFun Mega Pro 5V/16MHz <https://www.sparkfun.com/products/11007>`_
-      - ATMEGA2560
-      - 16 MHz
-      - 256 Kb
-      - 8 Kb
-
-    * - ``sparkfun_megapro8MHz``
-      - `SparkFun Mega Pro 3.3V/8MHz <https://www.sparkfun.com/products/10744>`_
-      - ATMEGA2560
-      - 8 MHz
-      - 256 Kb
-      - 8 Kb
-
-    * - ``sparkfun_promicro16``
-      - `SparkFun Pro Micro 5V/16MHz <https://www.sparkfun.com/products/12640>`_
-      - ATMEGA32U4
-      - 16 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``sparkfun_promicro8``
-      - `SparkFun Pro Micro 3.3V/8MHz <https://www.sparkfun.com/products/12587>`_
-      - ATMEGA32U4
-      - 8 MHz
-      - 32 Kb
-      - 2.5 Kb
-
-    * - ``sparkfun_redboard``
-      - `SparkFun RedBoard <https://www.sparkfun.com/products/12757>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``uview``
-      - `SparkFun MicroView <https://www.sparkfun.com/products/12923>`_
-      - ATMEGA328P
-      - 16 MHz
-      - 32 Kb
-      - 2 Kb
-
-TinyCircuits
-~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``tinyduino``
-      - `TinyCircuits TinyDuino Processor Board <https://tiny-circuits.com/tinyduino-processor-board.html>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-    * - ``tinylily``
-      - `TinyCircuits TinyLily Mini Processor <https://tiny-circuits.com/tiny-lily-mini-processor.html>`_
-      - ATMEGA328P
-      - 8 MHz
-      - 32 Kb
-      - 2 Kb
-
-Wicked Device
-~~~~~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``wildfirev2``
-      - `Wicked Device WildFire V2 <http://shop.wickeddevice.com/resources/wildfire/>`_
-      - ATMEGA1284P
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``wildfirev3``
-      - `Wicked Device WildFire V3 <http://shop.wickeddevice.com/resources/wildfire/>`_
-      - ATMEGA1284P
-      - 16 MHz
-      - 128 Kb
-      - 16 Kb

docs/platforms/atmelsam.rst

@@ -1,133 +0,0 @@
-.. _platform_atmelsam:
-
-Platform ``atmelsam``
-=====================
-Atmel | SMART offers Flash- based ARM products based on the ARM Cortex-M0+, Cortex-M3 and Cortex-M4 architectures, ranging from 8KB to 2MB of Flash including a rich peripheral and feature mix.
-
-For more detailed information please visit `vendor site <http://www.atmel.com/products/microcontrollers/arm/default.aspx>`_.
-
-.. contents::
-
-Packages
---------
-
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Contents
-
-    * - ``framework-arduinosam``
-      - `Arduino Wiring-based Framework (SAM Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
-
-    * - ``ldscripts``
-      - `Linker Scripts <https://sourceware.org/binutils/docs/ld/Scripts.html>`_
-
-    * - ``toolchain-gccarmnoneeabi``
-      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded>`_, `GDB <http://www.gnu.org/software/gdb/>`_
-
-    * - ``tool-bossac``
-      - `BOSSA CLI <https://sourceforge.net/projects/b-o-s-s-a/>`_
-
-.. warning::
-    **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
-
-    **Windows Users:** Please check that you have correctly installed USB driver
-    from board manufacturer
-
-
-
-Frameworks
-----------
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Description
-
-    * - :ref:`framework_arduino`
-      - Arduino Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
-
-Boards
-------
-
-.. note::
-    * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
-    * For more detailed ``board`` information please scroll tables below by
-      horizontal.
-
-Arduino
-~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``due``
-      - `Arduino Due (Programming Port) <http://arduino.cc/en/Main/arduinoBoardDue>`_
-      - AT91SAM3X8E
-      - 84 MHz
-      - 512 Kb
-      - 32 Kb
-
-    * - ``dueUSB``
-      - `Arduino Due (USB Native Port) <http://arduino.cc/en/Main/arduinoBoardDue>`_
-      - AT91SAM3X8E
-      - 84 MHz
-      - 512 Kb
-      - 32 Kb
-
-Digistump
-~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``digix``
-      - `Digistump DigiX <http://digistump.com/products/50>`_
-      - AT91SAM3X8E
-      - 84 MHz
-      - 512 Kb
-      - 28 Kb
-
-SainSmart
-~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``sainSmartDue``
-      - `SainSmart Due (Programming Port) <http://www.sainsmart.com/arduino/control-boards/sainsmart-due-atmel-sam3x8e-arm-cortex-m3-board-black.html>`_
-      - AT91SAM3X8E
-      - 84 MHz
-      - 512 Kb
-      - 32 Kb
-
-    * - ``sainSmartDueUSB``
-      - `SainSmart Due (USB Native Port) <http://www.sainsmart.com/arduino/control-boards/sainsmart-due-atmel-sam3x8e-arm-cortex-m3-board-black.html>`_
-      - AT91SAM3X8E
-      - 84 MHz
-      - 512 Kb
-      - 32 Kb

docs/platforms/creating_board.rst

@@ -1,62 +0,0 @@
-.. _board_creating:
-
-Creating Board
-==============
-
-*PlatformIO* has pre-built settings for the most popular embedded boards. This
-list is available:
-
-* `Embedded Boards Explorer <http://platformio.org/#!/boards>`_ (Web)
-* :ref:`cmd_boards` (CLI command)
-
-Nevertheless, PlatformIO allows to create own board or override existing
-board's settings. All data is declared using
-`JSON-style <http://en.wikipedia.org/wiki/JSON>`_ via
-`associative array <http://en.wikipedia.org/wiki/Associative_array>`_
-(name/value pairs).
-
-.. contents::
-
-JSON Structure
---------------
-
-The key fields:
-
-* ``build`` data will be used by :ref:`Platforms <platforms>` and
-  :ref:`frameworks` builders
-* ``frameworks`` is the list with supported :ref:`frameworks`
-* ``platform`` main type of :ref:`Platforms <platforms>`
-* ``upload`` upload settings which depend on the ``platform``
-
-.. code-block:: json
-
-    {
-        "myboard": {
-            "build": {},
-            "frameworks": ["%LIST_WITH_SUPPORTED_FRAMEWORKS%"],
-            "name": "My test board",
-            "platform": "%PLATFORM_TYPE_HERE%",
-            "upload": {},
-            "url": "http://example.com",
-            "vendor": "My Company Ltd."
-        }
-    }
-
-Installation
-------------
-
-1. Create ``boards`` directory in :ref:`projectconf_pio_home_dir` if it
-   doesn't exist.
-2. Create ``my_own_boards.json`` file and put to ``boards`` directory.
-3. Search available boards via :ref:`cmd_boards` command. You should see
-   ``myboard`` board.
-
-Now, you can use ``myboard`` for the :ref:`projectconf_env_board` option in
-:ref:`projectconf`.
-
-
-Examples
---------
-
-For the examples, please look into built-in ``*.json`` files with boards
-settings: https://github.com/platformio/platformio/tree/develop/platformio/boards.

docs/platforms/creating_platform.rst

@@ -1,431 +0,0 @@
-.. _platform_creating:
-
-Creating Platform
-=================
-
-*PlatformIO* was developed like a tool which would build the same source code
-for the different development platforms via single command :ref:`cmd_run`
-without any dependent software or requirements.
-
-For this purpose *PlatformIO* uses own pre-configured platforms data:
-build scripts, tool chains, the settings for the most popular embedded
-boards and etc. These data are pre-built and packaged to the different
-``packages``. It allows *PlatformIO* to have multiple development platforms
-which can use the same packages(tool chains, frameworks), but have
-different/own build scripts, uploader and etc.
-
-.. note::
-    If you want to change some build flags for the existing
-    :ref:`Platforms <platforms>`, you don't need to create (or duplicate) own
-    development platforms! Please use :ref:`projectconf_build_flags` option.
-
-**Step-by-Step Manual**
-
-1. Chose :ref:`platform_creating_packages` for platform
-2. Create :ref:`platform_creating_manifest_file`
-3. Create :ref:`platform_creating_build_script`
-4. Finish with the :ref:`platform_creating_installation`.
-
-.. contents::
-
-.. _platform_creating_packages:
-
-Packages
---------
-
-*PlatformIO* has pre-built packages for the most popular operation systems:
-*Mac OS*, *Linux (+ARM)* and *Windows*.
-
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Contents
-
-    * - ``framework-arduinoavr``
-      - `Arduino Wiring-based Framework (AVR Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
-
-    * - ``framework-arduinoespressif``
-      - `Arduino Wiring-based Framework (ESP8266 Core) <https://github.com/esp8266/Arduino>`_
-
-    * - ``framework-arduinomsp430``
-      - `Arduino Wiring-based Framework (MSP430 Core) <http://arduino.cc/en/Reference/HomePage>`_
-
-    * - ``framework-arduinosam``
-      - `Arduino Wiring-based Framework (SAM Core, 1.6) <http://arduino.cc/en/Reference/HomePage>`_
-
-    * - ``framework-arduinoteensy``
-      - `Arduino Wiring-based Framework <http://arduino.cc/en/Reference/HomePage>`_
-
-    * - ``framework-cmsis``
-      - `Vendor-independent hardware abstraction layer for the Cortex-M processor series <http://www.arm.com/products/processors/cortex-m/cortex-microcontroller-software-interface-standard.php>`_
-
-    * - ``framework-energiamsp430``
-      - `Energia Wiring-based Framework (MSP430 Core) <http://energia.nu/reference/>`_
-
-    * - ``framework-energiativa``
-      - `Energia Wiring-based Framework (LM4F Core) <http://energia.nu/reference/>`_
-
-    * - ``framework-libopencm3``
-      - `libOpenCM3 Framework <http://www.libopencm3.org/>`_
-
-    * - ``framework-mbed``
-      - `mbed Framework <http://mbed.org>`_
-
-    * - ``framework-spl``
-      - `Standard Peripheral Library for STM32 MCUs <http://www.st.com/web/catalog/tools/FM147/CL1794/SC961/SS1743/PF257890>`_
-
-    * - ``ldscripts``
-      - `Linker Scripts <https://sourceware.org/binutils/docs/ld/Scripts.html>`_
-
-    * - ``sdk-esp8266``
-      - `ESP8266 SDK <http://bbs.espressif.com>`_
-
-    * - ``tool-avrdude``
-      - `AVRDUDE <http://www.nongnu.org/avrdude/>`_
-
-    * - ``tool-bossac``
-      - `BOSSA CLI <https://sourceforge.net/projects/b-o-s-s-a/>`_
-
-    * - ``tool-esptool``
-      - `esptool-ck <https://github.com/igrr/esptool-ck>`_
-
-    * - ``tool-lm4flash``
-      - `Flash Programmer <http://www.ti.com/tool/lmflashprogrammer>`_
-
-    * - ``tool-micronucleus``
-      - `Micronucleus <https://github.com/micronucleus/micronucleus>`_
-
-    * - ``tool-mspdebug``
-      - `MSPDebug <http://mspdebug.sourceforge.net/>`_
-
-    * - ``tool-stlink``
-      - `ST-Link <https://github.com/texane/stlink>`_
-
-    * - ``tool-teensy``
-      - `Teensy Loader <https://www.pjrc.com/teensy/loader.html>`_
-
-    * - ``toolchain-atmelavr``
-      - `avr-gcc <https://gcc.gnu.org/wiki/avr-gcc>`_, `GDB <http://www.gnu.org/software/gdb/>`_, `AVaRICE <http://avarice.sourceforge.net/>`_, `SimulAVR <http://www.nongnu.org/simulavr/>`_
-
-    * - ``toolchain-gccarmlinuxgnueabi``
-      - `GCC for Linux ARM GNU EABI <https://gcc.gnu.org>`_, `GDB <http://www.gnu.org/software/gdb/>`_
-
-    * - ``toolchain-gccarmnoneeabi``
-      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded>`_, `GDB <http://www.gnu.org/software/gdb/>`_
-
-    * - ``toolchain-gcclinux32``
-      - `GCC for Linux i686 <https://gcc.gnu.org>`_
-
-    * - ``toolchain-gcclinux64``
-      - `GCC for Linux x86_64 <https://gcc.gnu.org>`_
-
-    * - ``toolchain-gccmingw32``
-      - `MinGW <http://www.mingw.org>`_
-
-    * - ``toolchain-timsp430``
-      - `msp-gcc <http://sourceforge.net/projects/mspgcc/>`_, `GDB <http://www.gnu.org/software/gdb/>`_
-
-    * - ``toolchain-xtensa``
-      - `xtensa-gcc <https://github.com/jcmvbkbc/gcc-xtensa>`_, `GDB <http://www.gnu.org/software/gdb/>`_
-
-.. _platform_creating_manifest_file:
-
-Manifest File
--------------
-
-A platform manifest file is a `Python <https://www.python.org>`_ script with the
-next requirements:
-
-1. The file should have ``.py`` extension
-2. The **name of the file** is the **platform name** (lowercase)
-3. The source code of this file should contain a ``class`` which describes your
-   own platform. The name of the ``class`` should start with your
-   **platform name** (the first letter should be capitalized) + ``Platform``
-   ending. This ``class`` should be derived from *PlatformIO* ``BasePlatform``
-   class.
-
-.. warning::
-    If you are new to *Python* language, please read:
-
-    * `Style Guide for Python Code <https://www.python.org/dev/peps/pep-0008>`_.
-    * A hash sign (#) that is not inside a string literal begins a comment.
-      All characters after the # and up to the physical line end are part
-      of the comment and the *Python* interpreter ignores them.
-
-Example of the **test** platform (``test.py``):
-
-.. code-block:: python
-
-    import os
-
-    from platformio.platforms.base import BasePlatform
-
-    class TestPlatform(BasePlatform):
-        # This is a description of your platform.
-        # Platformio uses it for the `platformio search / list` commands
-        """
-            My Test platform - test.py
-        """
-
-        PACKAGES = {
-
-            "toolchain-foo": {
-
-                # alias is used for quick access to package.
-                # For example,
-                # `> platformio install test --without-package=toolchain`
-                "alias": "toolchain",
-
-                # Flag which allows PlatformIO to install this package by
-                # default via `> platformio install test` command
-                "default": True
-            },
-
-            "tool-bar": {
-                "alias": "uploader",
-                "default": True
-            },
-
-            "framework-baz": {
-                "default": True
-            }
-        }
-
-        def get_build_script(self):
-            """ Returns a path to build script """
-
-            # You can return static path
-            #return "/path/to/test-builder.py"
-
-            # or detect dynamically if `test-builder.py` is located in the same
-            # folder with `test.py`
-            return os.path.join(
-                os.path.dirname(os.path.realpath(__file__)),
-                "test-builder.py"
-            )
-
-.. _platform_creating_build_script:
-
-Build Script
-------------
-
-Platform's build script is based on a next-generation build tool named
-`SCons <http://www.scons.org>`_. PlatformIO has own built-in firmware builder
-``env.BuildProgram`` with the nested libraries search. Please look into a
-base template of ``test-builder.py``.
-
-.. code-block:: python
-
-    """
-        Build script for test.py
-        test-builder.py
-    """
-
-    from os.path import join
-    from SCons.Script import AlwaysBuild, Builder, Default, DefaultEnvironment
-
-    env = DefaultEnvironment()
-
-    # A full list with the available variables
-    # http://www.scons.org/doc/production/HTML/scons-user.html#app-variables
-    env.Replace(
-        AR="ar",
-        AS="gcc",
-        CC="gcc",
-        CXX="g++",
-        OBJCOPY="objcopy",
-        RANLIB="ranlib",
-
-        ARFLAGS=["..."],
-
-        ASFLAGS=["flag1", "flag2", "flagN"],
-        CCFLAGS=["flag1", "flag2", "flagN"],
-        CXXFLAGS=["flag1", "flag2", "flagN"],
-        LINKFLAGS=["flag1", "flag2", "flagN"],
-
-        CPPDEFINES=["DEFINE_1", "DEFINE=2", "DEFINE_N"],
-
-        LIBS=["additional", "libs", "here"],
-
-        UPLOADER=join("$PIOPACKAGES_DIR", "tool-bar", "uploader"),
-        UPLOADCMD="$UPLOADER $SOURCES"
-    )
-
-    env.Append(
-        BUILDERS=dict(
-            ElfToBin=Builder(
-                action=" ".join([
-                    "$OBJCOPY",
-                    "-O",
-                    "binary",
-                    "$SOURCES",
-                    "$TARGET"]),
-                suffix=".bin"
-            )
-        )
-    )
-
-    # The source code of "platformio-build-tool" is here
-    # https://github.com/platformio/platformio/blob/develop/platformio/builder/tools/platformio.py
-
-    #
-    # Target: Build executable and linkable firmware
-    #
-    target_elf = env.BuildProgram()
-
-    #
-    # Target: Build the .bin file
-    #
-    target_bin = env.ElfToBin(join("$BUILD_DIR", "firmware"), target_elf)
-
-    #
-    # Target: Upload firmware
-    #
-    upload = env.Alias(["upload"], target_bin, "$UPLOADCMD")
-    AlwaysBuild(upload)
-
-    #
-    # Target: Define targets
-    #
-    Default(target_bin)
-
-
-Please look into the examples with built-in scripts for the popular
-platforms:
-
-* `baseavr.py <https://github.com/platformio/platformio/blob/develop/platformio/builder/scripts/baseavr.py>`_
-* `basearm.py <https://github.com/platformio/platformio/blob/develop/platformio/builder/scripts/basearm.py>`_
-* `atmelavr.py <https://github.com/platformio/platformio/blob/develop/platformio/builder/scripts/atmelavr.py>`_
-* `timsp430.py <https://github.com/platformio/platformio/blob/develop/platformio/builder/scripts/timsp430.py>`_
-* `ststm32.py <https://github.com/platformio/platformio/blob/develop/platformio/builder/scripts/ststm32.py>`_
-
-.. _platform_creating_installation:
-
-Installation
-------------
-
-1. Create ``platforms`` directory in :ref:`projectconf_pio_home_dir` if it
-   doesn't exist.
-2. Copy ``test.py`` and ``test-builder.py`` files to ``platforms`` directory.
-3. Search available platforms via :ref:`cmd_platforms_search` command. You should see
-   ``test`` platform.
-4. Install ``test`` platform via :ref:`cmd_platforms_install` command.
-
-Now, you can use ``test`` for the :ref:`projectconf_env_platform` option in
-:ref:`projectconf`.
-
-Example
--------
-
-Let's use the real example which was requested by our user in `issue 175 <https://github.com/platformio/platformio/issues/175>`_. Need to add support for uploading firmware using GDB to
-:ref:`platform_ststm32`.
-
-First of all, need to create new folder ``platforms`` in :ref:`projectconf_pio_home_dir`
-and copy there two files:
-
-1. Platform manifest file ``ststm32gdb.py`` with the next content:
-
-.. code-block:: python
-
-    import os
-
-    from platformio.platforms.ststm32 import Ststm32Platform
-
-
-    class Ststm32gdbPlatform(Ststm32Platform):
-
-        """
-        ST STM32 using GDB as uploader
-
-        http://www.st.com/web/en/catalog/mmc/FM141/SC1169?sc=stm32
-        """
-
-        def get_build_script(self):
-
-            return os.path.join(
-                os.path.dirname(os.path.realpath(__file__)),
-                "ststm32gdb-builder.py"
-            )
-
-2. Build script file ``ststm32gdb-builder.py`` with the next content:
-
-.. code-block:: python
-
-    """
-        Builder for ST STM32 Series ARM microcontrollers with GDB upload.
-    """
-
-    from os.path import join
-
-    from SCons.Script import (COMMAND_LINE_TARGETS, AlwaysBuild, Default,
-                              DefaultEnvironment, SConscript)
-
-
-    env = DefaultEnvironment()
-
-    SConscript(env.subst(join("$PIOBUILDER_DIR", "scripts", "basearm.py")))
-
-    env.Replace(
-        UPLOADER=join(
-            "$PIOPACKAGES_DIR", "toolchain-gccarmnoneeabi",
-            "bin", "arm-none-eabi-gdb"
-        ),
-        UPLOADERFLAGS=[
-            join("$BUILD_DIR", "firmware.elf"),
-            "-batch",
-            "-x", join("$PROJECT_DIR", "upload.gdb")
-        ],
-
-        UPLOADCMD="$UPLOADER $UPLOADERFLAGS"
-    )
-
-    env.Append(
-        CPPDEFINES=[
-            "${BOARD_OPTIONS['build']['variant'].upper()}"
-        ],
-
-        LINKFLAGS=[
-            "-nostartfiles",
-            "-nostdlib"
-        ]
-    )
-
-    #
-    # Target: Build executable and linkable firmware
-    #
-
-    target_elf = env.BuildProgram()
-
-    #
-    # Target: Build the .bin file
-    #
-
-    if "uploadlazy" in COMMAND_LINE_TARGETS:
-        target_firm = join("$BUILD_DIR", "firmware.bin")
-    else:
-        target_firm = env.ElfToBin(join("$BUILD_DIR", "firmware"), target_elf)
-
-    #
-    # Target: Print binary size
-    #
-
-    target_size = env.Alias("size", target_elf, "$SIZEPRINTCMD")
-    AlwaysBuild(target_size)
-
-    #
-    # Target: Upload by default .bin file
-    #
-
-    upload = env.Alias(
-        ["upload", "uploadlazy"], target_firm, "$UPLOADCMD")
-    AlwaysBuild(upload)
-
-    #
-    # Target: Define targets
-    #
-
-    Default([target_firm, target_size])
-
-Now, we should see ``ststm32gdb`` platform using :ref:`cmd_platforms_search` command output
-and can install it via :ref:`platformio platforms install ststm32gdb <cmd_platforms_install>` command.

docs/platforms/espressif.rst

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

docs/platforms/freescalekinetis.rst

@@ -1,115 +0,0 @@
-.. _platform_freescalekinetis:
-
-Platform ``freescalekinetis``
-=============================
-Freescale Kinetis Microcontrollers is family of multiple hardware- and software-compatible ARM Cortex-M0+, Cortex-M4 and Cortex-M7-based MCU series. Kinetis MCUs offer exceptional low-power performance, scalability and feature integration.
-
-For more detailed information please visit `vendor site <http://www.freescale.com/webapp/sps/site/homepage.jsp?code=KINETIS>`_.
-
-.. contents::
-
-Packages
---------
-
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Contents
-
-    * - ``framework-mbed``
-      - `mbed Framework <http://mbed.org>`_
-
-    * - ``toolchain-gccarmnoneeabi``
-      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded>`_, `GDB <http://www.gnu.org/software/gdb/>`_
-
-.. warning::
-    **Linux Users:** Don't forget to install "udev" rules file
-    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
-
-    **Windows Users:** Please check that you have correctly installed USB driver
-    from board manufacturer
-
-
-
-Frameworks
-----------
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Description
-
-    * - :ref:`framework_mbed`
-      - The mbed framework The mbed SDK has been designed to provide enough hardware abstraction to be intuitive and concise, yet powerful enough to build complex projects. It is built on the low-level ARM CMSIS APIs, allowing you to code down to the metal if needed. In addition to RTOS, USB and Networking libraries, a cookbook of hundreds of reusable peripheral and module libraries have been built on top of the SDK by the mbed Developer Community.
-
-Boards
-------
-
-.. note::
-    * You can list pre-configured boards by :ref:`cmd_boards` command or
-      `PlatformIO Boards Explorer <http://platformio.org/#!/boards>`_
-    * For more detailed ``board`` information please scroll tables below by
-      horizontal.
-
-Freescale
-~~~~~~~~~
-
-.. list-table::
-    :header-rows:  1
-
-    * - Type ``board``
-      - Name
-      - Microcontroller
-      - Frequency
-      - Flash
-      - RAM
-
-    * - ``IBMEthernetKit``
-      - `Ethernet IoT Starter Kit <http://developer.mbed.org/platforms/IBMEthernetKit/>`_
-      - MK64FN1M0VLL12
-      - 120 MHz
-      - 1024 Kb
-      - 256 Kb
-
-    * - ``frdm_k20d50m``
-      - `Freescale Kinetis FRDM-K20D50M <https://developer.mbed.org/platforms/FRDM-K20D50M/>`_
-      - MK20DX128VLH5
-      - 48 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``frdm_k22f``
-      - `Freescale Kinetis FRDM-K22F <https://developer.mbed.org/platforms/FRDM-K22F/>`_
-      - MK22FN512VLH12
-      - 120 MHz
-      - 512 Kb
-      - 128 Kb
-
-    * - ``frdm_k64f``
-      - `Freescale Kinetis FRDM-K64F <https://developer.mbed.org/platforms/FRDM-K64F/>`_
-      - MK64FN1M0VLL12
-      - 120 MHz
-      - 1024 Kb
-      - 256 Kb
-
-    * - ``frdm_kl05z``
-      - `Freescale Kinetis FRDM-KL05Z <https://developer.mbed.org/platforms/FRDM-KL05Z/>`_
-      - MKL05Z32VFM4
-      - 48 MHz
-      - 32 Kb
-      - 4 Kb
-
-    * - ``frdm_kl25z``
-      - `Freescale Kinetis FRDM-KL25Z <https://developer.mbed.org/platforms/KL25Z/>`_
-      - MKL25Z128VLK4
-      - 48 MHz
-      - 128 Kb
-      - 16 Kb
-
-    * - ``frdm_kl46z``
-      - `Freescale Kinetis FRDM-KL46Z <https://developer.mbed.org/platforms/FRDM-KL46Z/>`_
-      - MKL46Z256VLL4
-      - 48 MHz
-      - 256 Kb
-      - 32 Kb

docs/platforms/index.rst

@@ -1,51 +0,0 @@
-.. _platforms:
-
-Platforms & Embedded Boards
-===========================
-
-*PlatformIO* has pre-built different development platforms for popular OS
-(*Mac OS X, Linux (+ARM) and Windows*). Each of them include compiler,
-debugger, uploader (for embedded) and many other useful tools.
-
-Also it has pre-configured settings for most popular **Embedded Platform
-Boards**. You have no need to specify in :ref:`projectconf` type or frequency of
-MCU, upload protocol or etc. Please use ``board`` option.
-
-Embedded
---------
-
-.. toctree::
-    :maxdepth: 2
-
-    atmelavr
-    atmelsam
-    espressif
-    freescalekinetis
-    nordicnrf51
-    nxplpc
-    siliconlabsefm32
-    ststm32
-    teensy
-    timsp430
-    titiva
-
-Desktop
--------
-
-.. toctree::
-    :maxdepth: 2
-
-    native
-    linux_arm
-    linux_i686
-    linux_x86_64
-    windows_x86
-
-Own Platform/Board
-------------------
-
-.. toctree::
-    :maxdepth: 2
-
-    creating_platform
-    creating_board

docs/platforms/linux_arm.rst

@@ -1,21 +0,0 @@
-.. _platform_linux_arm:
-
-Platform ``linux_arm``
-======================
-Linux ARM is a Unix-like and mostly POSIX-compliant computer operating system (OS) assembled under the model of free and open-source software development and distribution. Using host OS (Mac OS X, Linux ARM) you can build native application for Linux ARM platform.
-
-For more detailed information please visit `vendor site <http://platformio.org/#!/platforms/linux_arm>`_.
-
-.. contents::
-
-Packages
---------
-
-.. list-table::
-    :header-rows:  1
-
-    * - Name
-      - Contents
-
-    * - ``toolchain-gccarmlinuxgnueabi``
-      - `GCC for Linux ARM GNU EABI <https://gcc.gnu.org>`_, `GDB <http://www.gnu.org/software/gdb/>`_