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